GoHighLevel Calendars API

Create Calendar Resource

POST/calendars/resources/:resourceType

POST /calendars/resources/:resourceType Create calendar resource by resource type It takes 1 path parameter and 7 body fields, requires the calendars/resources.write scope and authenticates with a sub-account (location) token.

Request and authentication

Method: POST
Full URL: https://services.leadconnectorhq.com/calendars/resources/:resourceType
Scopes: calendars/resources.write
Token type: Sub-account (location) token
Accepted auth: OAuth Access Token, Private Integration Token
API version header: Version: 2021-07-28
Schema verified: 22 June 2026

Path parameters

Substituted into the URL. Required by definition.

Name	Type	Description
`resourceType`required	`string`	One of: `equipments`, `rooms`

Request body

JSON body fields. Nested objects are shown indented under their parent.

Name	Type	Description
`locationId`required	`string`	—
`name`required	`string`	—
`description`required	`string`	—
`quantity`required	`number`	Quantity of the equipment.
`outOfService`required	`number`	Quantity of the out of service equipment.
`capacity`required	`number`	Capacity of the room.
`calendarIds`required	`array`	Service calendar IDs to be mapped with the resource. One equipment can only be mapped with one service calendar. One room can be mapped with multiple service calendars.

Response fields

Top-level fields returned on a successful call.

Name	Type	Description
`locationId`required	`string`	Location ID of the resource
`name`required	`string`	Name of the resource Example: `yoga room`
`resourceType`required	`string`	One of: `equipments`, `rooms`
`isActive`required	`boolean`	Whether the resource is active
`description`	`string`	Description of the resource
`quantity`	`number`	Quantity of the resource
`outOfService`	`number`	Indicates if the resource is out of service Example: `0`
`capacity`	`number`	Capacity of the resource Example: `85`
`calendarIds`required	`array`	Calendar IDs Example: `Jsj0xnlDDjw0SuvX1J13,oCM5feFC86FAAbcO7lJK`

Example request

Copy-paste ready. Swap YOUR_TOKEN for your access token or Private Integration Token, and the sample ID for your own.

curl -X POST 'https://services.leadconnectorhq.com/calendars/resources/YOUR_RESOURCETYPE' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{}'

Skip the schema lookup

Hylo gives your AI agent this schema — and the other 52 documented here — without you looking anything up. Ask in plain English; it picks the endpoint, fills the body, and can run the call against your own sub-account.

View pricing Read the setup guide

More calendars endpoints