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 |
| Planning Center docs | Planning Center Calendar API |
Each product client sends X-PCO-API-Version: 2026-06-22, the version these types were generated from. Override it with new PlanningCenter({ auth, versions: { calendar: '...' } }); the types won’t follow. See Products.
import { createCalendarClient } from '@mackenly/planningcenterkit/calendar';
const calendar = createCalendarClient({ auth: { applicationId: process.env.PCO_APP_ID!, secret: process.env.PCO_SECRET! } });
const { data: root } = await calendar.get(); // /calendar/v2Root collections
Properties on pco.calendar, named after their URL. pco.calendar.get() fetches the product root (/calendar/v2), and pco.calendar.edge(name) follows any root edge by name.
| Client path | Resource | Returns | Filters | Create |
|---|---|---|---|---|
pco.calendar.attachments |
Attachment | Collection | No | |
pco.calendar.calendars |
Calendar | Collection | No | |
pco.calendar.conflicts |
Conflict | Collection | future, resolved, unresolved |
No |
pco.calendar.event_instances |
EventInstance | Collection | all, approved, approved_conflict, approved_pending, approved_pending_conflict, approved_pending_rejected, approved_pending_rejected_conflict, approved_rejected, approved_rejected_conflict, approver, approver_subscriber, canceled, conflict, event_request_approved, event_request_approved_pending, event_request_approved_pending_rejected, event_request_approved_rejected, event_request_pending, event_request_pending_rejected, event_request_rejected, future, lost, lost_due_to_blockout, manager, manager_approver, manager_approver_subscriber, manager_subscriber, not_canceled, not_pending_event_requests, owner, owner_approver, owner_approver_subscriber, owner_manager, owner_manager_approver, owner_manager_approver_subscriber, owner_manager_subscriber, owner_subscriber, pending, pending_conflict, pending_rejected, pending_rejected_conflict, rejected, rejected_conflict, shared, subscriber, unresolved |
No |
pco.calendar.event_resource_requests |
EventResourceRequest | Collection | No | |
pco.calendar.events |
Event | Collection | future |
No |
pco.calendar.feeds |
Feed | Collection | No | |
pco.calendar.job_statuses |
JobStatus | Collection | No | |
pco.calendar.people |
Person | Collection | active, event_owners |
No |
pco.calendar.report_templates |
ReportTemplate | Collection | Yes | |
pco.calendar.resource_approval_groups |
ResourceApprovalGroup | Collection | No | |
pco.calendar.resource_bookings |
ResourceBooking | Collection | approved, approved_conflict, approved_pending, approved_pending_conflict, approved_pending_rejected, approved_pending_rejected_conflict, approved_rejected, approved_rejected_conflict, conflict, future, pending, pending_conflict, pending_rejected, pending_rejected_conflict, rejected, rejected_conflict, resources, rooms |
No |
pco.calendar.resource_folders |
ResourceFolder | Collection | resources, rooms |
Yes |
pco.calendar.resource_questions |
ResourceQuestion | Collection | No | |
pco.calendar.resources |
Resource | Collection | resources, rooms |
Yes |
pco.calendar.room_setups |
RoomSetup | Collection | shared_room_setups |
No |
pco.calendar.tag_groups |
TagGroup | Collection | required |
Yes |
pco.calendar.tags |
Tag | Collection | individual |
Yes |
Resources
| Resource | TypeScript | Description |
|---|---|---|
| Attachment | Calendar.Attachment |
A file or external link attached to an event. |
| Calendar | Calendar.Calendar2 |
Calendars associated with an Organization. |
| Conflict | Calendar.Conflict |
A conflict between two events caused by overlapping event resource requests. |
| ContainingResource | Calendar.ContainingResource |
The containing record for a RoomSetup. |
| Event | Calendar.Event |
An event. |
| EventConnection | Calendar.EventConnection |
A connection between a Calendar event and a record in another product |
| EventInstance | Calendar.EventInstance |
A specific occurrence of an event. |
| EventResourceAnswer | Calendar.EventResourceAnswer |
An answer to a question in a room or resource request. |
| EventResourceRequest | Calendar.EventResourceRequest |
A room or resource request for a specific event. |
| EventTime | Calendar.EventTime |
Start and end times for each event instance. |
| Feed | Calendar.Feed |
A feed belonging to an organization. |
| JobStatus | Calendar.JobStatus |
|
| Organization | Calendar.Organization |
An administrative structure, usually representing a single church. |
| Person | Calendar.Person |
The people in your organization with access to Calendar. |
| ReportTemplate | Calendar.ReportTemplate |
A template for generating a report. |
| RequiredApproval | Calendar.RequiredApproval |
Represents the relationship between a Resource and a Resource Approval Group. |
| Resource | Calendar.Resource |
A room or resource that can be requested for use as part of an event. |
| ResourceApprovalGroup | Calendar.ResourceApprovalGroup |
A group of people that can be attached to a room or resource in order to require their approval for booking. |
| ResourceBooking | Calendar.ResourceBooking |
A specific booking of a room or resource for an event instance. |
| ResourceFolder | Calendar.ResourceFolder |
An organizational folder containing rooms or resources. |
| ResourceQuestion | Calendar.ResourceQuestion |
A question to answer when requesting to book a room or resource. |
| ResourceSuggestion | Calendar.ResourceSuggestion |
A resource and quantity suggested by a room setup. |
| RoomSetup | Calendar.RoomSetup |
A diagram and list of suggested resources useful for predefined room setups. |
| Tag | Calendar.Tag |
An organizational tag that can be applied to events. |
| TagGroup | Calendar.TagGroup |
A grouping of tags for organizational purposes. |