An administrative structure, usually representing a single church. Contains date/time formatting and time zone preferences.
| Property | Value |
|---|---|
| Product | Calendar (pco.calendar, API version 2026-06-22) |
| Resource type | Organization |
| TypeScript | Calendar.Organization, attributes Calendar.OrganizationAttributes, schema Calendar.OrganizationSchema |
| Planning Center path | /calendar/v2 |
| Planning Center docs | Organization |
How to reach it
| Client path | Returns | Filters | Create |
|---|---|---|---|
pco.calendar.get() |
The product root | No | |
pco.calendar.people.id(personId).organization |
Collection | No |
From a collection, .id(organizationId) addresses one Organization: pco.calendar.people.id(personId).organization.id(organizationId). Collections support where, include, order, and pagination; single resources have get().
Attributes
On Calendar.OrganizationAttributes. Every resource also has id and type ('Organization') next to its attributes.
| Name | Type | Description |
|---|---|---|
calendar_starts_on |
string | null |
The day of the week the calendar starts on |
date_format |
string | null |
See details. |
name |
string | null |
The name of the organization |
onboarding |
boolean | null |
Only available when requested with the ?fields param |
time_zone |
string | null |
The time zone of the organization |
twenty_four_hour_time |
boolean | null |
See details. |
Attribute details
date_format
Possible values:
%d/%m/%Y: indicates date/month/year formatting%m/%d/%Y: indicates month/date/year formatting
twenty_four_hour_time
trueindicates hours for times will use a 24-hour clockfalseindicates hours for times will use a 12-hour clock
Querying
No documented where fields.
No documented order fields.
Edges
The product root’s edges are the root collections on pco.calendar.
Writing
| Property | Value |
|---|---|
| Create | No |
| Update | No |
| Delete | No |
Example
import type { Calendar } from '@mackenly/planningcenterkit';
const { data } = await pco.calendar.get(); // GET /calendar/v2
const root: Calendar.Organization = data;