Skip to content

ResourceApprovalGroup (Calendar)

A group of people that can be attached to a room or resource in order to require their approval for booking.

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;

Type to search…

↑↓ navigate↵ selectEsc close