Planning Center People API

Show Get https://www.planningcenteronline.com/people/1.xml

  • Only admins can update the Permissions field
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<person>
  <created-at type="datetime">2007-04-16T18:37:56Z</created-at>
  <created-by-id type="integer">1</created-by-id>
  <id type="integer">1</id>
  <first-name>Jeff</first-name>
  <last-name>Berg</last-name>
  <name>Berg</name>
  <permissions>
     [Disabled, Scheduled Viewer, Viewer, Scheduler, Editor, Administrator]
  </permissions>
  <updated-at type="datetime">2008-05-19T18:35:12Z</updated-at>
  <updated-by-id type="integer">17476</updated-by-id>
  <photo-thumbnail-url>http://.../photo-thumbnail.jpg</photo-thumbnail-url>
  <photo-url>http://.../photo-normal.jpg</photo-url>
  <contact-data>
    <addresses type="array">
      <address>
        <city>La Quinta</city>
        <id type="integer">33465</id>
        <state>CA</state>
        <street>78-100 Main Street
                Suite 202</street>
        <zip>92253</zip>
        <location>Work</location>
      </address>
    </addresses>
    <email-addresses type="array">
      <email-address>
        <address>jeff@ministrycentered.com</address>
        <id type="integer">127901</id>
        <location>Work</location>
      </email-address>
    </email-addresses>
    <phone-numbers type="array">
      <phone-number>
        <id type="integer">84740</id>
        <number>(888) 777-2821</number>
        <location>Home</location>
      </phone-number>
    </phone-numbers>
  </contact-data>
  <properties type="array">
    <property>
      <id type="integer">1012583</id>
      <field>Tech Team</field>
      <field-allows-multiple-selections>true</field-allows-multiple-selections>
      <option>Audio</option>
    </property>
    <property>
      <id type="integer">1012584</id>
      <field>Instruments Played</field>
      <field-allows-multiple-selections>true</field-allows-multiple-selections>
      <option>Acoustic Guitar</option>
    </property>
    <property>
      <id type="integer">1012585</id>
      <field>Instruments Played</field>
      <field-allows-multiple-selections>true</field-allows-multiple-selections>
      <option>Keys</option>
    </property>
    <property>
      <id type="integer">1012586</id>
      <field>Instruments Played</field>
      <field-allows-multiple-selections>true</field-allows-multiple-selections>
      <option>Piano</option>
    </property>
    <property>
      <id type="integer">1012587</id>
      <field>Vocal Part</field>
      <field-allows-multiple-selections>true</field-allows-multiple-selections>
      <option>Bass</option>
    </property>
  </properties>
</person>

List Get https://www.planningcenteronline.com/people.xml

  • Example Filters:
  • /people.xml?name=Berg,J
  • /people.xml?people_ids=34,12,51
  • /people.xml?since=2008051208300
  • /people.xml?show_disabled_accounts=true
  • /people.xml?show_all_accounts=true
1
2
3
4
5
6
7
8
<people>
  <person>
    ...
  </person>
  <person>
    ...
  </person>
</people>

List changed since Get https://www.planningcenteronline.com/people.xml?since=2008051208300

  • The since parameter should be in the yyyymmddhhmmss format and in UTC.
1
2
3
4
5
6
7
8
<people>
  <person>
    ...
  </person>
  <person>
    ...
  </person>
</people>

Search Get https://www.planningcenteronline.com/people.xml?name=Jeff

  • Other Search Strings: “Berg, Jeff”, “Berg”
1
2
3
4
5
6
7
8
<people>
  <person>
    ...
  </person>
  <person>
    ...
  </person>
</people>

Create Post https://www.planningcenteronline.com/people.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<person>
  <first-name>Jeff</first-name>
  <last-name>Berg</last-name>
  <contact-data>
    <addresses type="array">
      <address>
        <city>La Quinta</city>
        <state>CA</state>
        <street>78-100 Main Street</street>
        <zip>92253</zip>
        <location>Work</location>
      </address>
    </addresses>
    <email-addresses type="array">
      <email-address>
        <address>jeff@ministrycentered.com</address>
        <location>Work</location>
      </email-address>
    </email-addresses>
    <phone-numbers type="array">
      <phone-number>
        <number>(888) 777-2821</number>
        <location>Home</location>
      </phone-number>
    </phone-numbers>
  </contact-data>
</person>

Update Put https://www.planningcenteronline.com/people/1.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<person>
  <first-name>Jeff</first-name>
  <last-name>Berg</last-name>
 
  <contact-data>
    <addresses type="array">
      <address>
        <city>La Quinta</city>
        <state>CA</state>
        <street>78-100 Main Street</street>
        <zip>92253</zip>
        <location>Work</location>
      </address>
    </addresses>
    <email-addresses type="array">
      <email-address>
        <address>jeff@ministrycentered.com</address>
        <location>Work</location>
      </email-address>
    </email-addresses>
    <phone-numbers type="array">
      <phone-number>
        <number>(888) 777-2821</number>
        <location>Home</location>
      </phone-number>
    </phone-numbers>
  </contact-data>
</person>