Triggers

Triggers are what start an automation. They fire when something happens in your home, like a light turning on, a door opening, or the sun setting. When a trigger fires, the automation checks its conditions and then runs its actions.

Browse the full list below, or use the search box to find a specific trigger by name or description. Each trigger has its own page with a step-by-step UI walkthrough, examples, and a complete field reference.

New to triggers? Read about triggers in automations to learn how they fit together with conditions and actions.

Air quality

Carbon dioxide level changed air_quality.co2_changed Triggers after one or more carbon dioxide levels change.
Carbon dioxide level crossed threshold air_quality.co2_crossed_threshold Triggers after one or more carbon dioxide levels cross a threshold.
Carbon monoxide level changed air_quality.co_changed Triggers after one or more carbon monoxide levels change.
Carbon monoxide cleared air_quality.co_cleared Triggers after one or more carbon monoxide sensors stop detecting carbon monoxide.
Carbon monoxide level crossed threshold air_quality.co_crossed_threshold Triggers after one or more carbon monoxide levels cross a threshold.
Carbon monoxide detected air_quality.co_detected Triggers after one or more carbon monoxide sensors start detecting carbon monoxide.
Gas cleared air_quality.gas_cleared Triggers after one or more gas sensors stop detecting gas.
Gas detected air_quality.gas_detected Triggers after one or more gas sensors start detecting gas.
Nitrous oxide level changed air_quality.n2o_changed Triggers after one or more nitrous oxide levels change.
Nitrous oxide level crossed threshold air_quality.n2o_crossed_threshold Triggers after one or more nitrous oxide levels cross a threshold.
Nitrogen dioxide level changed air_quality.no2_changed Triggers after one or more nitrogen dioxide levels change.
Nitrogen dioxide level crossed threshold air_quality.no2_crossed_threshold Triggers after one or more nitrogen dioxide levels cross a threshold.
Nitrogen monoxide level changed air_quality.no_changed Triggers after one or more nitrogen monoxide levels change.
Nitrogen monoxide level crossed threshold air_quality.no_crossed_threshold Triggers after one or more nitrogen monoxide levels cross a threshold.
Ozone level changed air_quality.ozone_changed Triggers after one or more ozone levels change.
Ozone level crossed threshold air_quality.ozone_crossed_threshold Triggers after one or more ozone levels cross a threshold.
PM10 level changed air_quality.pm10_changed Triggers after one or more PM10 levels change.
PM10 level crossed threshold air_quality.pm10_crossed_threshold Triggers after one or more PM10 levels cross a threshold.
PM1 level changed air_quality.pm1_changed Triggers after one or more PM1 levels change.
PM1 level crossed threshold air_quality.pm1_crossed_threshold Triggers after one or more PM1 levels cross a threshold.
PM2.5 level changed air_quality.pm25_changed Triggers after one or more PM2.5 levels change.
PM2.5 level crossed threshold air_quality.pm25_crossed_threshold Triggers after one or more PM2.5 levels cross a threshold.
PM4 level changed air_quality.pm4_changed Triggers after one or more PM4 levels change.
PM4 level crossed threshold air_quality.pm4_crossed_threshold Triggers after one or more PM4 levels cross a threshold.
Smoke cleared air_quality.smoke_cleared Triggers after one or more smoke sensors stop detecting smoke.
Smoke detected air_quality.smoke_detected Triggers after one or more smoke sensors start detecting smoke.
Sulphur dioxide level changed air_quality.so2_changed Triggers after one or more sulphur dioxide levels change.
Sulphur dioxide level crossed threshold air_quality.so2_crossed_threshold Triggers after one or more sulphur dioxide levels cross a threshold.
Volatile organic compounds level changed air_quality.voc_changed Triggers after one or more volatile organic compound levels change.
Volatile organic compounds level crossed threshold air_quality.voc_crossed_threshold Triggers after one or more volatile organic compounds levels cross a threshold.
Volatile organic compounds ratio changed air_quality.voc_ratio_changed Triggers after one or more volatile organic compound ratios change.
Volatile organic compounds ratio crossed threshold air_quality.voc_ratio_crossed_threshold Triggers after one or more volatile organic compounds ratios cross a threshold.

Alarm control panel

Alarm armed alarm_control_panel.armed Triggers after one or more alarms become armed, regardless of the mode.
Alarm armed away alarm_control_panel.armed_away Triggers after one or more alarms become armed in away mode.
Alarm armed home alarm_control_panel.armed_home Triggers after one or more alarms become armed in home mode.
Alarm armed night alarm_control_panel.armed_night Triggers after one or more alarms become armed in night mode.
Alarm armed vacation alarm_control_panel.armed_vacation Triggers after one or more alarms become armed in vacation mode.
Alarm disarmed alarm_control_panel.disarmed Triggers after one or more alarms become disarmed.
Alarm triggered alarm_control_panel.triggered Triggers after one or more alarms become triggered.

Calendar

Calendar event ended calendar.event_ended Triggers when a calendar event ends.
Calendar event started calendar.event_started Triggers when a calendar event starts.

Door

Door closed door.closed Triggers after one or more doors close.
Door opened door.opened Triggers after one or more doors open.

Fan

Fan turned off fan.turned_off Triggers after one or more fans turn off.
Fan turned on fan.turned_on Triggers after one or more fans turn on.

Humidifier

Humidifier mode changed humidifier.mode_changed Triggers after the mode of one or more humidifiers changes.
Humidifier started drying humidifier.started_drying Triggers after one or more humidifiers start actively drying (dehumidifying).
Humidifier started humidifying humidifier.started_humidifying Triggers after one or more humidifiers start actively humidifying.
Humidifier turned off humidifier.turned_off Triggers after one or more humidifiers turn off.
Humidifier turned on humidifier.turned_on Triggers after one or more humidifiers turn on.

Humidity

Relative humidity changed humidity.changed Triggers after one or more relative humidity readings change.
Relative humidity crossed threshold humidity.crossed_threshold Triggers after one or more relative humidity readings cross a threshold.

Light

Light brightness changed light.brightness_changed Triggers after the brightness of one or more lights changes.
Light brightness crossed threshold light.brightness_crossed_threshold Triggers after the brightness of one or more lights crosses a threshold.
Light turned off light.turned_off Triggers after one or more lights turn off.
Light turned on light.turned_on Triggers after one or more lights turn on.

Temperature

Temperature changed temperature.changed Triggers after one or more temperature readings change.
Temperature crossed threshold temperature.crossed_threshold Triggers after one or more temperature readings cross a threshold.

Vacuum

Vacuum returned to dock vacuum.docked Triggers when a vacuum cleaner docks.
Vacuum encountered an error vacuum.errored Triggers when a vacuum cleaner reports an error.
Vacuum paused cleaning vacuum.paused_cleaning Triggers when a vacuum cleaner pauses cleaning.
Vacuum started cleaning vacuum.started_cleaning Triggers when a vacuum cleaner begins a cleaning task.
Vacuum started returning to dock vacuum.started_returning Triggers when a vacuum cleaner begins returning to its dock.

Window

Window closed window.closed Triggers after one or more windows close.
Window opened window.opened Triggers after one or more windows open.

air_quality.co2_changed - Triggers after one or more carbon dioxide levels change.

air_quality.co2_crossed_threshold - Triggers after one or more carbon dioxide levels cross a threshold.

air_quality.co_changed - Triggers after one or more carbon monoxide levels change.

air_quality.co_cleared - Triggers after one or more carbon monoxide sensors stop detecting carbon monoxide.

air_quality.co_crossed_threshold - Triggers after one or more carbon monoxide levels cross a threshold.

air_quality.co_detected - Triggers after one or more carbon monoxide sensors start detecting carbon monoxide.

air_quality.gas_cleared - Triggers after one or more gas sensors stop detecting gas.

air_quality.gas_detected - Triggers after one or more gas sensors start detecting gas.

air_quality.n2o_changed - Triggers after one or more nitrous oxide levels change.

air_quality.n2o_crossed_threshold - Triggers after one or more nitrous oxide levels cross a threshold.

air_quality.no2_changed - Triggers after one or more nitrogen dioxide levels change.

air_quality.no2_crossed_threshold - Triggers after one or more nitrogen dioxide levels cross a threshold.

air_quality.no_changed - Triggers after one or more nitrogen monoxide levels change.

air_quality.no_crossed_threshold - Triggers after one or more nitrogen monoxide levels cross a threshold.

air_quality.ozone_changed - Triggers after one or more ozone levels change.

air_quality.ozone_crossed_threshold - Triggers after one or more ozone levels cross a threshold.

air_quality.pm10_changed - Triggers after one or more PM10 levels change.

air_quality.pm10_crossed_threshold - Triggers after one or more PM10 levels cross a threshold.

air_quality.pm1_changed - Triggers after one or more PM1 levels change.

air_quality.pm1_crossed_threshold - Triggers after one or more PM1 levels cross a threshold.

air_quality.pm25_changed - Triggers after one or more PM2.5 levels change.

air_quality.pm25_crossed_threshold - Triggers after one or more PM2.5 levels cross a threshold.

air_quality.pm4_changed - Triggers after one or more PM4 levels change.

air_quality.pm4_crossed_threshold - Triggers after one or more PM4 levels cross a threshold.

air_quality.smoke_cleared - Triggers after one or more smoke sensors stop detecting smoke.

air_quality.smoke_detected - Triggers after one or more smoke sensors start detecting smoke.

air_quality.so2_changed - Triggers after one or more sulphur dioxide levels change.

air_quality.so2_crossed_threshold - Triggers after one or more sulphur dioxide levels cross a threshold.

air_quality.voc_changed - Triggers after one or more volatile organic compound levels change.

air_quality.voc_crossed_threshold - Triggers after one or more volatile organic compounds levels cross a threshold.

air_quality.voc_ratio_changed - Triggers after one or more volatile organic compound ratios change.

air_quality.voc_ratio_crossed_threshold - Triggers after one or more volatile organic compounds ratios cross a threshold.

alarm_control_panel.armed - Triggers after one or more alarms become armed, regardless of the mode.

alarm_control_panel.armed_away - Triggers after one or more alarms become armed in away mode.

alarm_control_panel.armed_home - Triggers after one or more alarms become armed in home mode.

alarm_control_panel.armed_night - Triggers after one or more alarms become armed in night mode.

alarm_control_panel.armed_vacation - Triggers after one or more alarms become armed in vacation mode.

alarm_control_panel.disarmed - Triggers after one or more alarms become disarmed.

alarm_control_panel.triggered - Triggers after one or more alarms become triggered.

calendar.event_ended - Triggers when a calendar event ends.

calendar.event_started - Triggers when a calendar event starts.

door.closed - Triggers after one or more doors close.

door.opened - Triggers after one or more doors open.

fan.turned_off - Triggers after one or more fans turn off.

fan.turned_on - Triggers after one or more fans turn on.

humidifier.mode_changed - Triggers after the mode of one or more humidifiers changes.

humidifier.started_drying - Triggers after one or more humidifiers start actively drying (dehumidifying).

humidifier.started_humidifying - Triggers after one or more humidifiers start actively humidifying.

humidifier.turned_off - Triggers after one or more humidifiers turn off.

humidifier.turned_on - Triggers after one or more humidifiers turn on.

humidity.changed - Triggers after one or more relative humidity readings change.

humidity.crossed_threshold - Triggers after one or more relative humidity readings cross a threshold.

light.brightness_changed - Triggers after the brightness of one or more lights changes.

light.brightness_crossed_threshold - Triggers after the brightness of one or more lights crosses a threshold.

light.turned_off - Triggers after one or more lights turn off.

light.turned_on - Triggers after one or more lights turn on.

temperature.changed - Triggers after one or more temperature readings change.

temperature.crossed_threshold - Triggers after one or more temperature readings cross a threshold.

vacuum.docked - Triggers when a vacuum cleaner docks.

vacuum.errored - Triggers when a vacuum cleaner reports an error.

vacuum.paused_cleaning - Triggers when a vacuum cleaner pauses cleaning.

vacuum.started_cleaning - Triggers when a vacuum cleaner begins a cleaning task.

vacuum.started_returning - Triggers when a vacuum cleaner begins returning to its dock.

window.closed - Triggers after one or more windows close.

window.opened - Triggers after one or more windows open.