GoHighLevel Calendars API

Edit Block Slot

PUT/calendars/events/block-slots/:eventId

PUT /calendars/events/block-slots/:eventId Update block slot by ID It takes 1 path parameter and 6 body fields, requires the calendars/events.write scope and authenticates with a sub-account (location) token.

Request and authentication

Method: PUT
Full URL: https://services.leadconnectorhq.com/calendars/events/block-slots/:eventId
Scopes: calendars/events.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

Notes from the field

Set EITHER `calendarId` OR `assignedUserId`, never both (GHL rejects both).

Path parameters

Substituted into the URL. Required by definition.

Name	Type	Description
`eventId`required	`string`	—

Request body

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

Name	Type	Description
`title`	`string`	Title Example: `Test Event`
`calendarId`required	`string`	Either calendarId or assignedUserId can be set, not both. Example: `CVokAlI8fgw4WYWoCtQz`
`assignedUserId`	`string`	Either calendarId or assignedUserId can be set, not both. Example: `CVokAlI8fgw4WYWoCtQz`
`locationId`required	`string`	Location Id Example: `C2QujeCh8ZnC7al2InWR`
`startTime`	`string`	Start Time Example: `2021-06-23T03:30:00+05:30`
`endTime`	`string`	End Time Example: `2021-06-23T04:30:00+05:30`

Response fields

Top-level fields returned on a successful call.

Name	Type	Description
`id`required	`string`	Id Example: `0TkCdp9PfvLeWKYRRvIz`
`locationId`required	`string`	Location Id Example: `C2QujeCh8ZnC7al2InWR`
`title`required	`string`	Title Example: `My event`
`startTime`required	`object`	Start Time Example: `2021-06-23T03:30:00+05:30`
`endTime`required	`object`	End Time Example: `2021-06-23T04:30:00+05:30`
`calendarId`	`string`	Calendar id Example: `CVokAlI8fgw4WYWoCtQz`
`assignedUserId`	`string`	Assigned User Id Example: `0007BWpSzSwfiuSl0tR2`

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/events/block-slots/YOUR_EVENTID' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "calendarId": "CVokAlI8fgw4WYWoCtQz",
    "locationId": "C2QujeCh8ZnC7al2InWR"
  }'

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