---
title: "Create a Climate Preset"
method: POST
path: "/thermostats/create_climate_preset"
tags: ["/thermostats"]
---

# Create a Climate Preset

`POST /thermostats/create_climate_preset`

## Request

- Base URL: `https://connect.getseam.com`
- URL: `https://connect.getseam.com/thermostats/create_climate_preset`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/seam/apis/seam-connect/docs/thermostats/create_climate_preset/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a [climate preset](/capability-guides/thermostats/creating-and-managing-climate-presets) for a specified [thermostat](/capability-guides/thermostats).

## Request body

- object
  - `climate_preset_key` string, required: Unique key to identify the [climate preset](/capability-guides/thermostats/creating-and-managing-climate-presets).
  - `climate_preset_mode` 'home' | 'away' | 'wake' | 'sleep' | 'occupied' | 'unoccupied': The climate preset mode for the thermostat, based on the available climate preset modes reported by the device.
  - `cooling_set_point_celsius` number, float: Temperature to which the thermostat should cool (in °C). See also [Set Points](/capability-guides/thermostats/understanding-thermostat-concepts/set-points).
  - `cooling_set_point_fahrenheit` number, float: Temperature to which the thermostat should cool (in °F). See also [Set Points](/capability-guides/thermostats/understanding-thermostat-concepts/set-points).
  - `device_id` string, uuid, required: ID of the thermostat device for which you want create a climate preset.
  - `ecobee_metadata` object: Metadata specific to the Ecobee climate, if applicable.
    - `climate_ref` string: Reference to the Ecobee climate, if applicable.
    - `is_optimized` boolean: Indicates if the climate preset is optimized by Ecobee.
    - `owner` 'user' | 'system': Indicates whether the climate preset is owned by the user or the system.
  - `fan_mode_setting` 'auto' | 'on' | 'circulate': Desired [fan mode setting](/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings), such as `on`, `auto`, or `circulate`.
  - `heating_set_point_celsius` number, float: Temperature to which the thermostat should heat (in °C). See also [Set Points](/capability-guides/thermostats/understanding-thermostat-concepts/set-points).
  - `heating_set_point_fahrenheit` number, float: Temperature to which the thermostat should heat (in °F). See also [Set Points](/capability-guides/thermostats/understanding-thermostat-concepts/set-points).
  - `hvac_mode_setting` 'off' | 'heat' | 'cool' | 'heat_cool' | 'eco': Desired [HVAC mode](/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`.
  - `manual_override_allowed` boolean: Deprecated. Use 'thermostat_schedule.is_override_allowed' Indicates whether a person at the thermostat or using the API can change the thermostat's settings.
  - `name` string, nullable: User-friendly name to identify the [climate preset](/capability-guides/thermostats/creating-and-managing-climate-presets).

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/seam/apis/seam-connect.md) - [All operations](https://skmtc.dev/seam/apis/seam-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/seam/apis/seam-connect/revisions/00c35395ce12?raw)
