---
title: "ResourceApprovalGroup (Calendar)"
description: "A group of people that can be attached to a room or resource in order to require their approval for booking."
---

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

# ResourceApprovalGroup (Calendar)

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

## 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](/guides/querying/); 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](#calendar-count). |
| `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](#person-count). |
| `resource_count` | `number \| null` | See [details](#resource-count). |
| `room_count` | `number \| null` | See [details](#room-count). |
| `updated_at` | `string \| null` | UTC time at which the approval group was updated |

### Attribute details

#### `calendar_count` {#calendar-count}

The number of calendars that require approval from the group

Only available when requested with the `?fields` param

#### `person_count` {#person-count}

The number of people in the approval group

Only available when requested with the `?fields` param

#### `resource_count` {#resource-count}

The number of resources in the approval group

Only available when requested with the `?fields` param

#### `room_count` {#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](/reference/calendar/calendar/) | Collection |  | No |
| `ref.event_resource_requests` | [EventResourceRequest](/reference/calendar/event-resource-request/) | Collection | `awaiting_response`, `future`, `not_in_conflict`, `not_overbooked`, `overbooked` | No |
| `ref.people` | [Person](/reference/calendar/person/) | Collection |  | No |
| `ref.required_approvals` | [RequiredApproval](/reference/calendar/required-approval/) | Collection | `resources`, `rooms` | No |
| `ref.resources` | [Resource](/reference/calendar/resource/) | Collection | `resources`, `rooms` | No |

## Writing

| Property | Value |
| --- | --- |
| Create | No |
| Update | No |
| Delete | No |

## Example

```ts
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;
```

Source: https://planningcenterkit.mackenly.com/reference/calendar/resource-approval-group/index.mdx
