Skip to content

Groups reference

Planning Center Groups in Planning Center Kit: Groups, group types, memberships, events, attendance, and tags.

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/v2

Root 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.

Type to search…

↑↓ navigate↵ selectEsc close