---
title: "Calendar reference"
description: "Planning Center Calendar in Planning Center Kit: Events, event instances, resources and rooms, resource bookings, and approvals."
---

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

# Calendar reference

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](https://api.planningcenteronline.com/docs/apps/calendar/versions/2026-06-22) |

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

```ts
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](/reference/calendar/attachment/) | Collection |  | No |
| `pco.calendar.calendars` | [Calendar](/reference/calendar/calendar/) | Collection |  | No |
| `pco.calendar.conflicts` | [Conflict](/reference/calendar/conflict/) | Collection | `future`, `resolved`, `unresolved` | No |
| `pco.calendar.event_instances` | [EventInstance](/reference/calendar/event-instance/) | 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](/reference/calendar/event-resource-request/) | Collection |  | No |
| `pco.calendar.events` | [Event](/reference/calendar/event/) | Collection | `future` | No |
| `pco.calendar.feeds` | [Feed](/reference/calendar/feed/) | Collection |  | No |
| `pco.calendar.job_statuses` | [JobStatus](/reference/calendar/job-status/) | Collection |  | No |
| `pco.calendar.people` | [Person](/reference/calendar/person/) | Collection | `active`, `event_owners` | No |
| `pco.calendar.report_templates` | [ReportTemplate](/reference/calendar/report-template/) | Collection |  | Yes |
| `pco.calendar.resource_approval_groups` | [ResourceApprovalGroup](/reference/calendar/resource-approval-group/) | Collection |  | No |
| `pco.calendar.resource_bookings` | [ResourceBooking](/reference/calendar/resource-booking/) | 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](/reference/calendar/resource-folder/) | Collection | `resources`, `rooms` | Yes |
| `pco.calendar.resource_questions` | [ResourceQuestion](/reference/calendar/resource-question/) | Collection |  | No |
| `pco.calendar.resources` | [Resource](/reference/calendar/resource/) | Collection | `resources`, `rooms` | Yes |
| `pco.calendar.room_setups` | [RoomSetup](/reference/calendar/room-setup/) | Collection | `shared_room_setups` | No |
| `pco.calendar.tag_groups` | [TagGroup](/reference/calendar/tag-group/) | Collection | `required` | Yes |
| `pco.calendar.tags` | [Tag](/reference/calendar/tag/) | Collection | `individual` | Yes |

## Resources

| Resource | TypeScript | Description |
| --- | --- | --- |
| [Attachment](/reference/calendar/attachment/) | `Calendar.Attachment` | A file or external link attached to an event. |
| [Calendar](/reference/calendar/calendar/) | `Calendar.Calendar2` | Calendars associated with an Organization. |
| [Conflict](/reference/calendar/conflict/) | `Calendar.Conflict` | A conflict between two events caused by overlapping event resource requests. |
| [ContainingResource](/reference/calendar/containing-resource/) | `Calendar.ContainingResource` | The containing record for a RoomSetup. |
| [Event](/reference/calendar/event/) | `Calendar.Event` | An event. |
| [EventConnection](/reference/calendar/event-connection/) | `Calendar.EventConnection` | A connection between a Calendar event and a record in another product |
| [EventInstance](/reference/calendar/event-instance/) | `Calendar.EventInstance` | A specific occurrence of an event. |
| [EventResourceAnswer](/reference/calendar/event-resource-answer/) | `Calendar.EventResourceAnswer` | An answer to a question in a room or resource request. |
| [EventResourceRequest](/reference/calendar/event-resource-request/) | `Calendar.EventResourceRequest` | A room or resource request for a specific event. |
| [EventTime](/reference/calendar/event-time/) | `Calendar.EventTime` | Start and end times for each event instance. |
| [Feed](/reference/calendar/feed/) | `Calendar.Feed` | A feed belonging to an organization. |
| [JobStatus](/reference/calendar/job-status/) | `Calendar.JobStatus` |  |
| [Organization](/reference/calendar/organization/) | `Calendar.Organization` | An administrative structure, usually representing a single church. |
| [Person](/reference/calendar/person/) | `Calendar.Person` | The people in your organization with access to Calendar. |
| [ReportTemplate](/reference/calendar/report-template/) | `Calendar.ReportTemplate` | A template for generating a report. |
| [RequiredApproval](/reference/calendar/required-approval/) | `Calendar.RequiredApproval` | Represents the relationship between a Resource and a Resource Approval Group. |
| [Resource](/reference/calendar/resource/) | `Calendar.Resource` | A room or resource that can be requested for use as part of an event. |
| [ResourceApprovalGroup](/reference/calendar/resource-approval-group/) | `Calendar.ResourceApprovalGroup` | A group of people that can be attached to a room or resource in order to require their approval for booking. |
| [ResourceBooking](/reference/calendar/resource-booking/) | `Calendar.ResourceBooking` | A specific booking of a room or resource for an event instance. |
| [ResourceFolder](/reference/calendar/resource-folder/) | `Calendar.ResourceFolder` | An organizational folder containing rooms or resources. |
| [ResourceQuestion](/reference/calendar/resource-question/) | `Calendar.ResourceQuestion` | A question to answer when requesting to book a room or resource. |
| [ResourceSuggestion](/reference/calendar/resource-suggestion/) | `Calendar.ResourceSuggestion` | A resource and quantity suggested by a room setup. |
| [RoomSetup](/reference/calendar/room-setup/) | `Calendar.RoomSetup` | A diagram and list of suggested resources useful for predefined room setups. |
| [Tag](/reference/calendar/tag/) | `Calendar.Tag` | An organizational tag that can be applied to events. |
| [TagGroup](/reference/calendar/tag-group/) | `Calendar.TagGroup` | A grouping of tags for organizational purposes. |

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