A group of people that can be attached to a room or resource in order to require their approval for booking.
| Property | Value |
|---|---|
| Product | Calendar (pco.calendar, API version 2026-06-22) |
| Resource type | ResourceApprovalGroup |
| TypeScript | Calendar.ResourceApprovalGroup, attributes Calendar.ResourceApprovalGroupAttributes, schema Calendar.ResourceApprovalGroupSchema |
| Planning Center path | /calendar/v2/resource_approval_groups |
| Planning Center docs | ResourceApprovalGroup |
How to reach it
| Client path | Returns | Filters | Create |
|---|---|---|---|
pco.calendar.resource_approval_groups |
Collection | No | |
pco.calendar.calendars.id(calendarId).approval_groups |
Collection | No | |
pco.calendar.resources.id(resourceId).resource_approval_groups |
Collection | No |
From a collection, .id(resourceApprovalGroupId) addresses one ResourceApprovalGroup: pco.calendar.resource_approval_groups.id(resourceApprovalGroupId). Collections support where, include, order, and pagination; single resources have get().
Attributes
On Calendar.ResourceApprovalGroupAttributes. Every resource also has id and type ('ResourceApprovalGroup') next to its attributes.
| Name | Type | Description |
|---|---|---|
calendar_count |
number | null |
See details. |
created_at |
string | null |
UTC time at which the approval group was created |
form_count |
number | null |
Only available when requested with the ?fields param |
name |
string | null |
Name of the approval group |
person_count |
number | null |
See details. |
resource_count |
number | null |
See details. |
room_count |
number | null |
See details. |
updated_at |
string | null |
UTC time at which the approval group was updated |
Attribute details
calendar_count
The number of calendars that require approval from the group
Only available when requested with the ?fields param
person_count
The number of people in the approval group
Only available when requested with the ?fields param
resource_count
The number of resources in the approval group
Only available when requested with the ?fields param
room_count
The number of rooms in the approval group
Only available when requested with the ?fields param
Relationships and includes
Side-load with include() (or get({ include })) and read with related(resource, name): calendars, people, resources.
Querying
Where
where(field, value) for equality; where(field, op, value) with the operators listed.
| Field | Value type | Operators |
|---|---|---|
created_at |
string | Date |
gt, gte, lt, lte |
id |
string |
Equality only |
name |
string |
Equality only |
updated_at |
string | Date |
gt, gte, lt, lte |
Order
order(...) accepts these fields, ascending, or descending with a - prefix: created_at, name, updated_at.
Edges
Follow these from one ResourceApprovalGroup, ref = pco.calendar.resource_approval_groups.id(resourceApprovalGroupId):
| Edge | Leads to | Returns | Filters | Create |
|---|---|---|---|---|
ref.calendars |
Calendar | Collection | No | |
ref.event_resource_requests |
EventResourceRequest | Collection | awaiting_response, future, not_in_conflict, not_overbooked, overbooked |
No |
ref.people |
Person | Collection | No | |
ref.required_approvals |
RequiredApproval | Collection | resources, rooms |
No |
ref.resources |
Resource | Collection | resources, rooms |
No |
Writing
| Property | Value |
|---|---|
| Create | No |
| Update | No |
| Delete | No |
Example
import type { Calendar } from '@mackenly/planningcenterkit';
const page = await pco.calendar.resource_approval_groups.order('created_at').perPage(25).list();
const items: Calendar.ResourceApprovalGroup[] = page.data;