GoHighLevel Calendars API

Update Schedule

PUT/calendars/schedules/:id

PUT /calendars/schedules/:id Update user availability schedule. Modify an existing schedule by updating its rules, timezone, and name All fields are optional - only provided fields will be updated It takes 1 path parameter and 3 body fields, requires the calendars.write scope and authenticates with a sub-account (location) token.

Request and authentication

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

Path parameters

Substituted into the URL. Required by definition.

Name	Type	Description
`id`required	`string`	Example: `sch123def456ghi789`

Request body

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

Name Type Description

name

string

Human-readable name for the schedule

Example: Updated Business Hours

rules

array

Updated schedule rules defining when the schedule is active

Example: [object Object]

timezone

string

Updated timezone for the schedule (IANA timezone identifier)

Example: America/Los_Angeles

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, and the sample ID for your own.

curl -X PUT 'https://services.leadconnectorhq.com/calendars/schedules/sch123def456ghi789' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Updated Business Hours",
    "rules": [
      {
        "type": "wday",
        "day": "monday",
        "intervals": [
          {
            "from": "08:00",
            "to": "18:00"
          }
        ]
      }
    ],
    "timezone": "America/Los_Angeles"
  }'

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