GoHighLevel Calendars API

Create Schedule

POST/calendars/schedules

POST /calendars/schedules Create new schedule with specified rules, timezone, location, user and calendar associations It takes 6 body fields, requires the calendars.write scope and authenticates with a sub-account (location) token.

Request and authentication

Method: POST
Full URL: https://services.leadconnectorhq.com/calendars/schedules
Scopes: calendars.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

Request body

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

Name	Type	Description
`rules`	`array`	Schedule rules defining when the schedule is active Example: `[object Object]`
`timezone`required	`string`	Timezone for the schedule (IANA timezone identifier) Example: `America/New_York`
`locationId`required	`string`	Location ID where this schedule applies Example: `IkqiJlXJ7o9h61tCHHod`
`name`required	`string`	Human-readable name for the schedule Example: `Business Hours Schedule`
`userId`required	`string`	User ID associated with the schedule Example: `IkqiJlXJ7o9h61tCHHod`
`calendarIds`	`array`	Calendar IDs associated with the schedule Example: `WvVX9LpvlBO6K506xLbp,XyZ8MnQrStUvWxYzAbCdEf`

Response fields

Top-level fields returned on a successful call.

Name	Type	Description
`schedule`required	`unknown`	Schedule

Example request

Copy-paste ready. Swap YOUR_TOKEN for your access token or Private Integration Token.

curl -X POST 'https://services.leadconnectorhq.com/calendars/schedules' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "timezone": "America/New_York",
    "locationId": "IkqiJlXJ7o9h61tCHHod",
    "name": "Business Hours Schedule",
    "userId": "IkqiJlXJ7o9h61tCHHod"
  }'

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