---
title: "Create Comfort Setting"
method: POST
path: "/thermostats/{thermostatId}/comfortSettings"
tags: ["thermostats"]
---

# Create Comfort Setting

`POST /thermostats/{thermostatId}/comfortSettings`

## Request

- Base URL: `https://api.sb.ecobee.com/api/v2`
- URL: `https://api.sb.ecobee.com/api/v2/thermostats/{thermostatId}/comfortSettings`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.sb.ecobee.com/api/v2/token` scopes: `read:thermostat`, `write:thermostat`

Creates a comfort setting for a thermostat

## Request body

- object
  - `name` string, required: The display name for the climate. Must be unique.
  - `setPoint` SetPoint, required
    - `desiredCool` number, float
    - `desiredHeat` number, float
  - `heatFan` 'on' | 'auto'
  - `coolFan` 'on' | 'auto'

## Response `200`

Success

- ThermostatComfortSetting
  - `status` 'success'
  - `heatFan` 'on' | 'auto'
  - `coolFan` 'on' | 'auto'
  - `setpoint` SetPoint
    - `desiredCool` number, float
    - `desiredHeat` number, float
  - `name` string
  - `comfortSettingRef` string

## Other responses

- `400`: Bad request
- `401`: Not authenticated
- `403`: Not authorized
- `404`: Not found
- `422`: Validation Failed
- `429`: Too many requests
- `500`: Internal server error
- `default`: Unexpected error

---

[API](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api.md) - [All operations](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api/revisions/d78d4fd5e1c6?raw)