Doorbell
The Doorbell integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides an automation trigger for event entities with the doorbell device class.
Supported entities
The Doorbell integration supports the following entity types:
- Event entities with the doorbell device class.
Configuration
The Doorbell integration does not require any configuration.
Supported functionality
The Doorbell integration provides the following automation trigger for doorbell event entities.
List of triggers
The Doorbell integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following triggers. Each link below opens a dedicated page with examples, fields, and a step-by-step UI walkthrough.
-
Doorbell rang (
doorbell.rang) Triggers when one or more doorbells ring.
For an overview of every trigger across all integrations, see the triggers reference.
Doorbell automation examples
You can use this trigger to get a notification when someone is at the door, or to turn on a light when someone rings.
You don’t need to edit YAML to use these examples. Copy a YAML snippet from this page, open the automation editor in Home Assistant, and press Ctrl+V (or Cmd+V on Mac). Home Assistant automatically converts the pasted YAML into the visual editor format, whether it’s a full automation, a single trigger, a condition, or an action.
Automation: send a notification when someone rings the doorbell
Get a notification on your phone when someone rings the front door, so you know someone is there even when you can’t hear the chime.
-
Trigger: Doorbell rang
- Target: Front door doorbell
-
Action: Send a notification message
-
Target: My Device (
notify.my_device)
-
Target: My Device (
YAML example for a doorbell notification
alias: "Notify when someone rings the doorbell"
triggers:
- trigger: doorbell.rang
target:
entity_id: event.front_door_doorbell
actions:
- action: notify.send_message
target:
entity_id: notify.my_device
data:
message: "Someone rang the front door doorbell."
Automation: turn on the porch light when someone rings after sunset
When someone rings the doorbell after sunset, turn on the porch light so you can see who is at the door.
-
Trigger: Doorbell rang
- Target: Front door doorbell
-
Condition: State
- Entity: Sun
- State: Below horizon
-
Action: Turn on light
- Target: Porch light
YAML example for turning on the porch light
alias: "Turn on the porch light when someone rings after sunset"
triggers:
- trigger: doorbell.rang
target:
entity_id: event.front_door_doorbell
conditions:
- condition: state
entity_id: sun.sun
state: "below_horizon"
actions:
- action: light.turn_on
target:
entity_id: light.porch