A question to answer when requesting to book a room or resource.
| Property | Value |
|---|---|
| Product | Calendar (pco.calendar, API version 2026-06-22) |
| Resource type | ResourceQuestion |
| TypeScript | Calendar.ResourceQuestion, attributes Calendar.ResourceQuestionAttributes, schema Calendar.ResourceQuestionSchema |
| Planning Center path | /calendar/v2/resource_questions |
| Planning Center docs | ResourceQuestion |
How to reach it
| Client path | Returns | Filters | Create |
|---|---|---|---|
pco.calendar.resource_questions |
Collection | No | |
pco.calendar.resources.id(resourceId).resource_questions |
Collection | Yes |
From a collection, .id(resourceQuestionId) addresses one ResourceQuestion: pco.calendar.resource_questions.id(resourceQuestionId). Collections support where, include, order, and pagination; single resources have get().
Attributes
On Calendar.ResourceQuestionAttributes. Every resource also has id and type ('ResourceQuestion') next to its attributes.
| Name | Type | Description |
|---|---|---|
choices |
string | null |
If kind is dropdown, represents a string of dropdown choices separated by the | character |
created_at |
string | null |
UTC time at which the question was created |
description |
string | null |
Optional description of the question |
kind |
string | null |
See details. |
multiple_select |
boolean | null |
If kind is dropdown, true indicates that more than one selection is permitted |
optional |
boolean | null |
See details. |
position |
number | null |
Position of question in list in the UI |
question |
string | null |
The question to be answered |
updated_at |
string | null |
UTC time at which the question was updated |
Attribute details
kind
Possible values:
-
dropdown: predefined list of choices as an answer -
paragraph: expected answer is a paragraph -
text: expected answer is a sentence -
yesno: expected answer is ‘Yes’ or ‘No’ -
section_header: used to separate questions in the UI, no expected answer
optional
trueindicates answering the question is not required when bookingfalseindicates answering the question is required when booking
Relationships and includes
Planning Center documents no includes for this resource.
| Relationship | Type | To | Includable |
|---|---|---|---|
resource |
To one | Resource | No |
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 |
kind |
string |
Equality only |
updated_at |
string | Date |
gt, gte, lt, lte |
No documented order fields.
Edges
This resource has no documented edges.
Writing
| Property | Value |
|---|---|
| Create | Yes, create() on resource_questions on Resource |
| Update | Yes, update() on a reference |
| Delete | Yes, delete() on a reference |
Create attributes
Typed as Calendar.ResourceQuestionSchema['create'].
| Attribute | Type |
|---|---|
choices |
string | null |
description |
string | null |
kind |
string | null |
multiple_select |
boolean | null |
optional |
boolean | null |
position |
number | null |
question |
string | null |
Update attributes
Typed as Calendar.ResourceQuestionSchema['update'].
| Attribute | Type |
|---|---|
choices |
string | null |
description |
string | null |
kind |
string | null |
multiple_select |
boolean | null |
optional |
boolean | null |
position |
number | null |
question |
string | null |
See Writing data.
Example
import type { Calendar } from '@mackenly/planningcenterkit';
const page = await pco.calendar.resource_questions.perPage(25).list();
const items: Calendar.ResourceQuestion[] = page.data;