Skip to main content

​
thermostat.climate_preset_activated

A thermostat climate preset was activated.
Example webhook payload
{
  "climate_preset_key": "",
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "customer_key": "",
  "device_custom_metadata": {},
  "device_id": "00000000-0000-0000-0000-000000000000",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "thermostat.climate_preset_activated",
  "is_fallback_climate_preset": true,
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "thermostat_schedule_id": "00000000-0000-0000-0000-000000000000",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
​
climate_preset_key
String
Key of the climate preset that was activated.
​
connected_account_custom_metadata
Object
Custom metadata of the connected account, present when connected_account_id is provided.
​
connected_account_id
String (UUID)
ID of the connected account associated with the event.
​
created_at
String (ISO 8601)
Date and time at which the event was created.
​
customer_key
String
The customer key associated with the device, if any.
​
device_custom_metadata
Object
Custom metadata of the device, present when device_id is provided.
​
device_id
String (UUID)
ID of the affected device.
​
event_id
String (UUID)
ID of the event.
​
event_type
Enum (String)
Value: thermostat.climate_preset_activated
​
is_fallback_climate_preset
Boolean
Indicates whether the climate preset that was activated is the fallback climate preset for the thermostat.
​
occurred_at
String (ISO 8601)
Date and time at which the event occurred.
​
thermostat_schedule_id
String (UUID)
ID of the thermostat schedule that prompted the affected climate preset to be activated.
​
workspace_id
String (UUID)
ID of the workspace associated with the event.

​
thermostat.manually_adjusted

A thermostat was adjusted manually.
Example webhook payload
{
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "cooling_set_point_celsius": 0,
  "cooling_set_point_fahrenheit": 0,
  "created_at": "2025-01-01T00:00:00.000Z",
  "customer_key": "",
  "device_custom_metadata": {},
  "device_id": "00000000-0000-0000-0000-000000000000",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "thermostat.manually_adjusted",
  "fan_mode_setting": "auto",
  "heating_set_point_celsius": 0,
  "heating_set_point_fahrenheit": 0,
  "hvac_mode_setting": "off",
  "method": "seam",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
​
connected_account_custom_metadata
Object
Custom metadata of the connected account, present when connected_account_id is provided.
​
connected_account_id
String (UUID)
ID of the connected account associated with the event.
​
cooling_set_point_celsius
number
Temperature to which the thermostat should cool (in °C). See also Set Points.
​
cooling_set_point_fahrenheit
number
Temperature to which the thermostat should cool (in °F). See also Set Points.
​
created_at
String (ISO 8601)
Date and time at which the event was created.
​
customer_key
String
The customer key associated with the device, if any.
​
device_custom_metadata
Object
Custom metadata of the device, present when device_id is provided.
​
device_id
String (UUID)
ID of the affected device.
​
event_id
String (UUID)
ID of the event.
​
event_type
Enum (String)
Value: thermostat.manually_adjusted
​
fan_mode_setting
Enum (String)
Desired fan mode setting, such as on, auto, or circulate.Possible values: auto, on, circulate
​
heating_set_point_celsius
number
Temperature to which the thermostat should heat (in °C). See also Set Points.
​
heating_set_point_fahrenheit
number
Temperature to which the thermostat should heat (in °F). See also Set Points.
​
hvac_mode_setting
Enum (String)
Desired HVAC mode setting, such as heat, cool, heat_cool, or off.Possible values: off, heat, cool, heat_cool, eco
​
method
Enum (String)
Method used to adjust the affected thermostat manually. seam indicates that the Seam API, Seam CLI, or Seam Console was used to adjust the thermostat.Possible values: seam, external
​
occurred_at
String (ISO 8601)
Date and time at which the event occurred.
​
workspace_id
String (UUID)
ID of the workspace associated with the event.

​
thermostat.temperature_threshold_exceeded

A thermostat’s temperature reading exceeded the set threshold.
Example webhook payload
{
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "customer_key": "",
  "device_custom_metadata": {},
  "device_id": "00000000-0000-0000-0000-000000000000",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "thermostat.temperature_threshold_exceeded",
  "lower_limit_celsius": 0,
  "lower_limit_fahrenheit": 0,
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "temperature_celsius": 0,
  "temperature_fahrenheit": 0,
  "upper_limit_celsius": 0,
  "upper_limit_fahrenheit": 0,
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
​
connected_account_custom_metadata
Object
Custom metadata of the connected account, present when connected_account_id is provided.
​
connected_account_id
String (UUID)
ID of the connected account associated with the event.
​
created_at
String (ISO 8601)
Date and time at which the event was created.
​
customer_key
String
The customer key associated with the device, if any.
​
device_custom_metadata
Object
Custom metadata of the device, present when device_id is provided.
​
device_id
String (UUID)
ID of the affected device.
​
event_id
String (UUID)
ID of the event.
​
event_type
Enum (String)
Value: thermostat.temperature_threshold_exceeded
​
lower_limit_celsius
number
Lower temperature limit, in °C, defined by the set threshold.
​
lower_limit_fahrenheit
number
Lower temperature limit, in °F, defined by the set threshold.
​
occurred_at
String (ISO 8601)
Date and time at which the event occurred.
​
temperature_celsius
number
Temperature, in °C, reported by the affected thermostat.
​
temperature_fahrenheit
number
Temperature, in °F, reported by the affected thermostat.
​
upper_limit_celsius
number
Upper temperature limit, in °C, defined by the set threshold.
​
upper_limit_fahrenheit
number
Upper temperature limit, in °F, defined by the set threshold.
​
workspace_id
String (UUID)
ID of the workspace associated with the event.

​
thermostat.temperature_threshold_no_longer_exceeded

A thermostat’s temperature reading no longer exceeds the set threshold.
Example webhook payload
{
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "customer_key": "",
  "device_custom_metadata": {},
  "device_id": "00000000-0000-0000-0000-000000000000",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "thermostat.temperature_threshold_no_longer_exceeded",
  "lower_limit_celsius": 0,
  "lower_limit_fahrenheit": 0,
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "temperature_celsius": 0,
  "temperature_fahrenheit": 0,
  "upper_limit_celsius": 0,
  "upper_limit_fahrenheit": 0,
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
​
connected_account_custom_metadata
Object
Custom metadata of the connected account, present when connected_account_id is provided.
​
connected_account_id
String (UUID)
ID of the connected account associated with the event.
​
created_at
String (ISO 8601)
Date and time at which the event was created.
​
customer_key
String
The customer key associated with the device, if any.
​
device_custom_metadata
Object
Custom metadata of the device, present when device_id is provided.
​
device_id
String (UUID)
ID of the affected device.
​
event_id
String (UUID)
ID of the event.
​
event_type
Enum (String)
Value: thermostat.temperature_threshold_no_longer_exceeded
​
lower_limit_celsius
number
Lower temperature limit, in °C, defined by the set threshold.
​
lower_limit_fahrenheit
number
Lower temperature limit, in °F, defined by the set threshold.
​
occurred_at
String (ISO 8601)
Date and time at which the event occurred.
​
temperature_celsius
number
Temperature, in °C, reported by the affected thermostat.
​
temperature_fahrenheit
number
Temperature, in °F, reported by the affected thermostat.
​
upper_limit_celsius
number
Upper temperature limit, in °C, defined by the set threshold.
​
upper_limit_fahrenheit
number
Upper temperature limit, in °F, defined by the set threshold.
​
workspace_id
String (UUID)
ID of the workspace associated with the event.

​
thermostat.temperature_reached_set_point

A thermostat’s temperature reading is within 1 °C of the configured cooling or heating set point.
Example webhook payload
{
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "customer_key": "",
  "desired_temperature_celsius": 0,
  "desired_temperature_fahrenheit": 0,
  "device_custom_metadata": {},
  "device_id": "00000000-0000-0000-0000-000000000000",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "thermostat.temperature_reached_set_point",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "temperature_celsius": 0,
  "temperature_fahrenheit": 0,
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
​
connected_account_custom_metadata
Object
Custom metadata of the connected account, present when connected_account_id is provided.
​
connected_account_id
String (UUID)
ID of the connected account associated with the event.
​
created_at
String (ISO 8601)
Date and time at which the event was created.
​
customer_key
String
The customer key associated with the device, if any.
​
desired_temperature_celsius
number
Desired temperature, in °C, defined by the affected thermostat’s cooling or heating set point.
​
desired_temperature_fahrenheit
number
Desired temperature, in °F, defined by the affected thermostat’s cooling or heating set point.
​
device_custom_metadata
Object
Custom metadata of the device, present when device_id is provided.
​
device_id
String (UUID)
ID of the affected device.
​
event_id
String (UUID)
ID of the event.
​
event_type
Enum (String)
Value: thermostat.temperature_reached_set_point
​
occurred_at
String (ISO 8601)
Date and time at which the event occurred.
​
temperature_celsius
number
Temperature, in °C, reported by the affected thermostat.
​
temperature_fahrenheit
number
Temperature, in °F, reported by the affected thermostat.
​
workspace_id
String (UUID)
ID of the workspace associated with the event.

​
thermostat.temperature_changed

A thermostat’s reported temperature changed by at least 1 °C.
Example webhook payload
{
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "customer_key": "",
  "device_custom_metadata": {},
  "device_id": "00000000-0000-0000-0000-000000000000",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "thermostat.temperature_changed",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "temperature_celsius": 0,
  "temperature_fahrenheit": 0,
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
​
connected_account_custom_metadata
Object
Custom metadata of the connected account, present when connected_account_id is provided.
​
connected_account_id
String (UUID)
ID of the connected account associated with the event.
​
created_at
String (ISO 8601)
Date and time at which the event was created.
​
customer_key
String
The customer key associated with the device, if any.
​
device_custom_metadata
Object
Custom metadata of the device, present when device_id is provided.
​
device_id
String (UUID)
ID of the affected device.
​
event_id
String (UUID)
ID of the event.
​
event_type
Enum (String)
Value: thermostat.temperature_changed
​
occurred_at
String (ISO 8601)
Date and time at which the event occurred.
​
temperature_celsius
number
Temperature, in °C, reported by the affected thermostat.
​
temperature_fahrenheit
number
Temperature, in °F, reported by the affected thermostat.
​
workspace_id
String (UUID)
ID of the workspace associated with the event.