Groups, group types, memberships, events, attendance, and tags.
| Property | Value |
|---|---|
| Client property | pco.groups |
| Subpath import | import { createGroupsClient } from '@mackenly/planningcenterkit/groups' |
| Types namespace | Groups |
| Base path | /groups/v2 |
| Pinned API version | 2026-11-10 |
| Resource types | 17 |
| Planning Center docs | Planning Center Groups API |
Each product client sends X-PCO-API-Version: 2026-11-10, the version these types were generated from. Override it with new PlanningCenter({ auth, versions: { groups: '...' } }); the types won’t follow. See Products.
import { createGroupsClient } from '@mackenly/planningcenterkit/groups';
const groups = createGroupsClient({ auth: { applicationId: process.env.PCO_APP_ID!, secret: process.env.PCO_SECRET! } });
const { data: root } = await groups.get(); // /groups/v2Root collections
Properties on pco.groups, named after their URL. pco.groups.get() fetches the product root (/groups/v2), and pco.groups.edge(name) follows any root edge by name.
| Client path | Resource | Returns | Filters | Create |
|---|---|---|---|---|
pco.groups.campuses |
Campus | Collection | No | |
pco.groups.event_notes |
EventNote | Collection | No | |
pco.groups.events |
Event | Collection | campus, canceled, group, group_type, my_groups, not_canceled, upcoming |
No |
pco.groups.group_applications |
GroupApplication | Collection | No | |
pco.groups.group_types |
GroupType | Collection | church_center_visible, not_church_center_visible |
No |
pco.groups.groups |
Group | Collection | campus, enrollment, group, group_type, meeting_schedule, my_groups, people_database_searchable, tag |
No |
pco.groups.memberships |
Membership | Collection | group, leader, person |
No |
pco.groups.people |
Person | Collection | No | |
pco.groups.tag_groups |
TagGroup | Collection | public |
No |
Resources
| Resource | TypeScript | Description |
|---|---|---|
| Attendance | Groups.Attendance |
Individual event attendance for a person. |
| Campus | Groups.Campus |
A campus as defined in Planning Center Accounts |
| Enrollment | Groups.Enrollment |
Details on how and when members can join a Group. |
| Event | Groups.Event |
An event is a meeting of a group. |
| EventNote | Groups.EventNote |
Notes that group leaders can write for an event, generally related to attendance. |
| Group | Groups.Group |
A group of people that meet together regularly. |
| GroupApplication | Groups.GroupApplication |
A group application is a request to join a group which can be approved or rejected. |
| GroupType | Groups.GroupType |
A group type is a category of groups. |
| Location | Groups.Location |
A physical event location |
| Membership | Groups.Membership |
The state of a Person belonging to a Group. |
| Organization | Groups.Organization |
The organization represents a single church. |
| Owner | Groups.Owner |
The owner/creator of an event note. |
| Person | Groups.Person |
A person is a user of Planning Center. |
| Resource | Groups.Resource |
A file or link resource that can be shared with a group. |
| RSVP | Groups.RSVP |
A person’s RSVP response for a group event. |
| Tag | Groups.Tag |
Tags are used to filter groups. |
| TagGroup | Groups.TagGroup |
A way to group related tags. |