---
title: "Groups reference"
description: "Planning Center Groups in Planning Center Kit: Groups, group types, memberships, events, attendance, and tags."
---

> Documentation Index
> Fetch the complete documentation index at: https://planningcenterkit.mackenly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Groups reference

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](https://api.planningcenteronline.com/docs/apps/groups/versions/2026-11-10) |

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](/guides/products/).

```ts
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](/reference/groups/campus/) | Collection |  | No |
| `pco.groups.event_notes` | [EventNote](/reference/groups/event-note/) | Collection |  | No |
| `pco.groups.events` | [Event](/reference/groups/event/) | Collection | `campus`, `canceled`, `group`, `group_type`, `my_groups`, `not_canceled`, `upcoming` | No |
| `pco.groups.group_applications` | [GroupApplication](/reference/groups/group-application/) | Collection |  | No |
| `pco.groups.group_types` | [GroupType](/reference/groups/group-type/) | Collection | `church_center_visible`, `not_church_center_visible` | No |
| `pco.groups.groups` | [Group](/reference/groups/group/) | Collection | `campus`, `enrollment`, `group`, `group_type`, `meeting_schedule`, `my_groups`, `people_database_searchable`, `tag` | No |
| `pco.groups.memberships` | [Membership](/reference/groups/membership/) | Collection | `group`, `leader`, `person` | No |
| `pco.groups.people` | [Person](/reference/groups/person/) | Collection |  | No |
| `pco.groups.tag_groups` | [TagGroup](/reference/groups/tag-group/) | Collection | `public` | No |

## Resources

| Resource | TypeScript | Description |
| --- | --- | --- |
| [Attendance](/reference/groups/attendance/) | `Groups.Attendance` | Individual event attendance for a person. |
| [Campus](/reference/groups/campus/) | `Groups.Campus` | A campus as defined in Planning Center Accounts |
| [Enrollment](/reference/groups/enrollment/) | `Groups.Enrollment` | Details on how and when members can join a Group. |
| [Event](/reference/groups/event/) | `Groups.Event` | An event is a meeting of a group. |
| [EventNote](/reference/groups/event-note/) | `Groups.EventNote` | Notes that group leaders can write for an event, generally related to attendance. |
| [Group](/reference/groups/group/) | `Groups.Group` | A group of people that meet together regularly. |
| [GroupApplication](/reference/groups/group-application/) | `Groups.GroupApplication` | A group application is a request to join a group which can be approved or rejected. |
| [GroupType](/reference/groups/group-type/) | `Groups.GroupType` | A group type is a category of groups. |
| [Location](/reference/groups/location/) | `Groups.Location` | A physical event location |
| [Membership](/reference/groups/membership/) | `Groups.Membership` | The state of a Person belonging to a Group. |
| [Organization](/reference/groups/organization/) | `Groups.Organization` | The organization represents a single church. |
| [Owner](/reference/groups/owner/) | `Groups.Owner` | The owner/creator of an event note. |
| [Person](/reference/groups/person/) | `Groups.Person` | A person is a user of Planning Center. |
| [Resource](/reference/groups/resource/) | `Groups.Resource` | A file or link resource that can be shared with a group. |
| [RSVP](/reference/groups/rsvp/) | `Groups.RSVP` | A person's RSVP response for a group event. |
| [Tag](/reference/groups/tag/) | `Groups.Tag` | Tags are used to filter groups. |
| [TagGroup](/reference/groups/tag-group/) | `Groups.TagGroup` | A way to group related tags. |

Source: https://planningcenterkit.mackenly.com/reference/groups/index.mdx
