HighLevel: Update event calendar availability schedule

← Calendars operations · Get started

Operation gohighlevel.updatecalendarschedule

Provider route: PUT /calendars/schedules/event-calendar/{calendarId}. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/gohighlevel with npm, or alter-sdk-gohighlevel with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { HighLevelIntegration } from "@alter-ai/gohighlevel";

async function execute(input: Parameters<HighLevelIntegration["calendars"]["updateCalendarSchedule"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new HighLevelIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.calendars.updateCalendarSchedule(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_gohighlevel import HighLevelIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = HighLevelIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.calendars.update_calendar_schedule(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
path	object	Required within parent	Additional keys: not allowed
path.calendarId	string	Required within parent
body	Model	Required within parent	Expand Update event calendar availability schedule — request body — body

Referenced models: Update event calendar availability schedule — request body — body

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand Get event calendar availability schedule — response body

Referenced models: Get event calendar availability schedule — response body

Schemas

Get event calendar availability schedule — response body

Field	Type	Presence	Description and constraints
$	object	Root
schedule	JSON	Required within parent	The event calendar schedule
schedule (allOf 1)	Model	All variants apply	Expand Get event calendar availability schedule — response body — schedule calendar Id, date Added, date Updated, rules, timezone

Referenced models: Get event calendar availability schedule — response body — schedule calendar Id, date Added, date Updated, rules, timezone

Update event calendar availability schedule — request body — body

Field	Type	Presence	Description and constraints
$	object	Root
rules	array	Optional	Updated schedule rules defining when the schedule is active
rules[]	Model	Each item	Expand Create user availability schedule — request body — body rules item
timezone	string	Optional	Updated timezone for the schedule (IANA timezone identifier) Pattern: ^[A-Za-z_]+/[A-Za-z_]+$

Referenced models: Create user availability schedule — request body — body rules item

Get event calendar availability schedule — response body — schedule calendar Id, date Added, date Updated, rules, timezone

Field	Type	Presence	Description and constraints
$	object	Root
calendarId	string	Required within parent	Calendar ID associated with the schedule
dateAdded	string	Optional	Information about who created the schedule
dateUpdated	string	Optional	Information about who last updated the schedule
rules	array	Required within parent	Schedule rules defining when the schedule is active
rules[]	Model	Each item	Expand List user availability schedule — response body — schedules item rules item
timezone	string	Required within parent	Timezone for the schedule (IANA timezone identifier)

Referenced models: List user availability schedule — response body — schedules item rules item

Create user availability schedule — request body — body rules item

Field	Type	Presence	Description and constraints
$	object	Root
date	string	Optional	Specific date in YYYY-MM-DD format (only for date-type rules) Pattern: ^\d{4}-\d{2}-\d{2}$
day	string	Optional	Day of week (only for weekday-type rules) One of: sunday, monday, tuesday, wednesday, thursday, friday, saturday
intervals	array	Required within parent	Time intervals for the rule (e.g., 9 AM to 5 PM)
intervals[]	Model	Each item	Expand Create user availability schedule — request body — body rules item intervals item
type	string	Required within parent	Type of schedule rule - weekday (recurring) or date (specific date) One of: wday, date

Referenced models: Create user availability schedule — request body — body rules item intervals item

List user availability schedule — response body — schedules item rules item

Field	Type	Presence	Description and constraints
$	object	Root
date	string	Optional	Specific date in YYYY-MM-DD format (only for date-type rules) Pattern: ^\d{4}-\d{2}-\d{2}$
day	string	Optional	Day of week (only for weekday-type rules) Known values: sunday, monday, tuesday, wednesday, thursday, friday, saturday
intervals	array	Required within parent	Time intervals for the rule (e.g., 9 AM to 5 PM)
intervals[]	Model	Each item	Expand Create user availability schedule — request body — body rules item intervals item
type	string	Required within parent	Type of schedule rule - weekday (recurring) or date (specific date) Known values: wday, date

Referenced models: Create user availability schedule — request body — body rules item intervals item

Create user availability schedule — request body — body rules item intervals item

Field	Type	Presence	Description and constraints
$	object	Root
from	string	Required within parent	Start time in HH:MM format (24-hour format) Pattern: ^([01]?[0-9]|2[0-3]):[0-5][0-9]$
to	string	Required within parent	End time in HH:MM format (24-hour format) Pattern: ^([01]?[0-9]|2[0-3]):[0-5][0-9]$

Policy, approvals and errors

SDK function policy ID: gohighlevel.updatecalendarschedule. Catalog operation: updateCalendarSchedule. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["calendars.write"]

Pinned headers: {"Version": "v3"}

Official provider source