Skip to content

Calendar reference

Planning Center Calendar in Planning Center Kit: Events, event instances, resources and rooms, resource bookings, and approvals.

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

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

Type to search…

↑↓ navigate↵ selectEsc close