> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Create schedule

> Creates an availability schedule.

`highlevel.createSchedule` creates an availability schedule.

```ts automations/highlevel-create-schedule.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { highlevel } from "automate.ax/highlevel"

export default automation("Create schedule", () => {
  markSignificant(
    highlevel.createSchedule({
      timezone: "America/New_York",
      name: "Business Hours Schedule",
      userId: "IkqiJlXJ7o9h61tCHHod",
    }),
  )
})
```

## Input

| Field         | Type       | Required | Description                                          |
| ------------- | ---------- | -------- | ---------------------------------------------------- |
| `rules`       | `object[]` | No       | Schedule rules defining when the schedule is active  |
| `timezone`    | `string`   | Yes      | Timezone for the schedule (IANA timezone identifier) |
| `name`        | `string`   | Yes      | Human-readable name for the schedule                 |
| `userId`      | `string`   | Yes      | User ID associated with the schedule                 |
| `calendarIds` | `string[]` | No       | Calendar IDs associated with the schedule            |

Automate.ax supplies the connected sub-account's location ID. Optional second argument `{ account }` selects a named HighLevel binding.

## Output

| Field      | Type         | Required | Description |
| ---------- | ------------ | -------- | ----------- |
| `schedule` | `JSON value` | Yes      | Schedule    |

This action calls `POST /calendars/schedules` with HighLevel API version `2021-04-15` and requires `calendars.write`. HighLevel validation and permission errors fail the action. Rate limits honor the provider's retry timing. Automate.ax does not automatically replay this create or send operation after an indeterminate transport failure.