Planning Center Kit covers all 11 Planning Center products. Each one is a property on
PlanningCenter, a standalone client from its own subpath import, and a namespace of types.
import { PlanningCenter } from '@mackenly/planningcenterkit';
const pco = new PlanningCenter({ auth: { applicationId: '...', secret: '...' } });
await pco.checkIns.check_ins.order('-created_at').first();import { createCheckInsClient } from '@mackenly/planningcenterkit/check-ins';
const checkIns = createCheckInsClient({ auth: { applicationId: '...', secret: '...' } });
await checkIns.check_ins.order('-created_at').first();Standalone clients take the same options as PlanningCenter plus version, or an existing
transport to share rate limiting and credentials (see
Errors and retries).
Webhooks naming: pco.webhooks and @mackenly/planningcenterkit/webhooks-api are the
Webhooks product API (subscriptions, available events, deliveries).
@mackenly/planningcenterkit/webhooks is for receiving webhooks (signature verification and
parsing); see Webhooks.
API versions: each product is pinned to the version of Planning Center’s documentation its
types were generated from, sent as X-PCO-API-Version. Override with
new PlanningCenter({ auth, versions: { checkIns: '2025-01-01' } }) or
createCheckInsClient({ auth, version: '2025-01-01' }); the types won’t follow an override.
The reference has a page per product and per resource with every client path, attribute, and query option.
Root collections are the properties on each product client, named after their URL
(pco.people.people is /people/v2/people). “(create)” marks the ones you can create() on.
Every client also has get() for the product root (usually the organization) and edge(name).
API
OAuth applications, personal access tokens, and connected applications.
| Property | Value |
|---|---|
| Client property | pco.api |
| Subpath import | import { createApiClient } from '@mackenly/planningcenterkit/api' |
| Types namespace | Api |
| Base path | /api/v2 |
| Pinned API version | 2026-09-24 |
| Resource types | 7 |
| Reference | API reference |
| Planning Center docs | developer.planning.center/docs/#/apps/api |
Root collections: connected_applications, oauth_applications, personal_access_tokens.
Calendar
Events, event instances, resources and rooms, resource bookings, and approvals.
| Property | Value |
|---|---|
| Client property | pco.calendar |
| Subpath import | import { createCalendarClient } from '@mackenly/planningcenterkit/calendar' |
| Types namespace | Calendar |
| Base path | /calendar/v2 |
| Pinned API version | 2026-06-22 |
| Resource types | 25 |
| Reference | Calendar reference |
| Planning Center docs | developer.planning.center/docs/#/apps/calendar |
Root collections: attachments, calendars, conflicts, event_instances, event_resource_requests, events, feeds, job_statuses, people, report_templates (create), resource_approval_groups, resource_bookings, resource_folders (create), resource_questions, resources (create), room_setups, tag_groups (create), tags (create).
Check-Ins
Events, check-ins, locations, stations, labels, passes, and headcounts.
| Property | Value |
|---|---|
| Client property | pco.checkIns |
| Subpath import | import { createCheckInsClient } from '@mackenly/planningcenterkit/check-ins' |
| Types namespace | CheckIns |
| Base path | /check-ins/v2 |
| Pinned API version | 2025-05-28 |
| Resource types | 24 |
| Reference | Check-Ins reference |
| Planning Center docs | developer.planning.center/docs/#/apps/check-ins |
Root collections: check_ins, event_times, events, headcounts, integration_links, labels, options, passes, people, stations, themes.
Current
The legacy Current donations product.
| Property | Value |
|---|---|
| Client property | pco.current |
| Subpath import | import { createCurrentClient } from '@mackenly/planningcenterkit/current' |
| Types namespace | Current |
| Base path | /current/v2 |
| Pinned API version | 2018-08-01 |
| Resource types | 2 |
| Reference | Current reference |
| Planning Center docs | developer.planning.center/docs/#/apps/current |
Root collections: people.
Giving
Donations, funds, batches, pledges, payment sources, and recurring donations.
| Property | Value |
|---|---|
| Client property | pco.giving |
| Subpath import | import { createGivingClient } from '@mackenly/planningcenterkit/giving' |
| Types namespace | Giving |
| Base path | /giving/v2 |
| Pinned API version | 2019-10-18 |
| Resource types | 20 |
| Reference | Giving reference |
| Planning Center docs | developer.planning.center/docs/#/apps/giving |
Root collections: batch_groups (create), batches (create), campuses, donations, donor_summaries, funds (create), in_kind_donations (create), labels (create), payment_sources (create), people, pledge_campaigns (create), recurring_donations.
Groups
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 |
| Reference | Groups reference |
| Planning Center docs | developer.planning.center/docs/#/apps/groups |
Root collections: campuses, event_notes, events, group_applications, group_types, groups, memberships, people, tag_groups.
People
People, households, lists, forms, workflows, notes, and custom fields.
| Property | Value |
|---|---|
| Client property | pco.people |
| Subpath import | import { createPeopleClient } from '@mackenly/planningcenterkit/people' |
| Types namespace | People |
| Base path | /people/v2 |
| Pinned API version | 2026-10-05 |
| Resource types | 67 |
| Reference | People reference |
| Planning Center docs | developer.planning.center/docs/#/apps/people |
pco.people.me is the person the credentials belong to (GET /people/v2/me): await pco.people.me.get().
Root collections: addresses, apps, background_checks, birthday_people, campuses (create), carriers, emails, field_data, field_definitions, form_categories (create), forms, households (create), inactive_reasons (create), list_categories (create), lists, marital_statuses (create), membership_types (create), message_groups, messages, name_prefixes (create), name_suffixes (create), note_categories (create), note_category_subscriptions, notes, people (create), people_imports, person_mergers, phone_numbers, reports (create), school_options (create), social_profiles, spam_email_addresses, stats, tabs (create), workflow_assignee_summaries, workflows (create).
Publishing
Channels, episodes, series, speakers, and announcements.
| Property | Value |
|---|---|
| Client property | pco.publishing |
| Subpath import | import { createPublishingClient } from '@mackenly/planningcenterkit/publishing' |
| Types namespace | Publishing |
| Base path | /publishing/v2 |
| Pinned API version | 2024-03-25 |
| Resource types | 17 |
| Reference | Publishing reference |
| Planning Center docs | developer.planning.center/docs/#/apps/publishing |
Root collections: announcement_categories, announcements, channels (create), episodes (create), series (create), speakers.
Registrations
Signups, registrations, attendees, and categories.
| Property | Value |
|---|---|
| Client property | pco.registrations |
| Subpath import | import { createRegistrationsClient } from '@mackenly/planningcenterkit/registrations' |
| Types namespace | Registrations |
| Base path | /registrations/v2 |
| Pinned API version | 2025-05-01 |
| Resource types | 11 |
| Reference | Registrations reference |
| Planning Center docs | developer.planning.center/docs/#/apps/registrations |
Root collections: attendees, campuses, categories, people, registrations, signups.
Services
Service types, plans, items, songs and arrangements, teams, and schedules.
| Property | Value |
|---|---|
| Client property | pco.services |
| Subpath import | import { createServicesClient } from '@mackenly/planningcenterkit/services' |
| Types namespace | Services |
| Base path | /services/v2 |
| Pinned API version | 2018-11-01 |
| Resource types | 65 |
| Reference | Services reference |
| Planning Center docs | developer.planning.center/docs/#/apps/services |
Root collections: attachment_types, chat, email_templates (create), folders (create), media (create), people, plans, report_templates, series, service_types (create), songs (create), tag_groups, teams (create).
Webhooks
Webhook subscriptions, available events, and deliveries.
| Property | Value |
|---|---|
| Client property | pco.webhooks |
| Subpath import | import { createWebhooksClient } from '@mackenly/planningcenterkit/webhooks-api' |
| Types namespace | Webhooks |
| Base path | /webhooks/v2 |
| Pinned API version | 2022-10-20 |
| Resource types | 5 |
| Reference | Webhooks reference |
| Planning Center docs | developer.planning.center/docs/#/apps/webhooks |
Root collections: available_events, webhook_subscriptions (create).