---
title: "Create a Thermostat Schedule"
method: POST
path: "/thermostats/schedules/create"
tags: ["/thermostats"]
---

# Create a Thermostat Schedule

`POST /thermostats/schedules/create`

Creates a new [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules) for a specified [thermostat](/capability-guides/thermostats).

## Request body

- object
  - `climate_preset_key` string, required — Key of the [climate preset](/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the new thermostat schedule.
  - `device_id` string, required — ID of the thermostat device for which you want to create a schedule.
  - `ends_at` string, required — Date and time at which the new thermostat schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
  - `is_override_allowed` boolean — Indicates whether a person at the thermostat or using the API can change the thermostat's settings while the new schedule is active. See also [Specifying Manual Override Permissions](/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
  - `max_override_period_minutes` integer, nullable — Number of minutes for which a person at the thermostat or using the API can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
  - `name` string — Name of the thermostat schedule.
  - `starts_at` string, required — Date and time at which the new thermostat schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.

## Response `200`

OK

- object
  - `thermostat_schedule` ThermostatSchedule, required — Represents a [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules) that activates a configured [climate preset](/capability-guides/thermostats/creating-and-managing-climate-presets) on a [thermostat](/capability-guides/thermostats) at a specified starting time and deactivates the climate preset at a specified ending time. See the [thermostat_schedule object](/api/thermostats/schedules/object).
    - `climate_preset_key` string, required — Key of the [climate preset](/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
    - `created_at` string, date-time, required — Date and time at which the [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules) was created.
    - `device_id` string, uuid, required — ID of the desired [thermostat](/capability-guides/thermostats) device.
    - `ends_at` string, date-time, required — Date and time at which the [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules) ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
    - `errors` object[], required — Errors associated with the [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
      - `error_code` string, required — Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
      - `message` string, required — Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
    - `is_override_allowed` boolean — Indicates whether a person at the thermostat can change the thermostat's settings after the [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules) starts.
    - `max_override_period_minutes` integer, nullable — Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled [climate preset](/capability-guides/thermostats/creating-and-managing-climate-presets). See also [Specifying Manual Override Permissions](/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
    - `name` string, nullable, required — User-friendly name to identify the [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
    - `starts_at` string, date-time, required — Date and time at which the [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules) starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
    - `thermostat_schedule_id` string, uuid, required — ID of the [thermostat schedule](/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
    - `workspace_id` string, uuid, required — ID of the workspace that contains the thermostat schedule.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/seam/apis/seam-connect.md) · [All operations](https://skmtc.net/seam/apis/seam-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seam/seam-connect/revisions/00c35395ce12/schema)