SimpliSafe

The SimpliSafe integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] integrates SimpliSafe home security (V2 and V3) systems into Home Assistant. Multiple SimpliSafe accounts can be accommodated.

There is currently support for the following device types within Home Assistant:

• Alarm control panel: reports on the current alarm status and can be used to arm and disarm the system.
• CO detector: reports on the carbon monoxide sensor status*.
• Camera: reports motion.
• Doorbell: reports detection.
• Entry sensor: reports on the current entry sensor status*.
• Freeze sensor: reports on the freeze sensor temperature*.
• Glass Break Sensor: reports on the glass breakage sensor status*.
• Lock: reports on Door Locks and can be used to lock and unlock a lock.
• Motion Sensor: reports on motion detected*.
• Siren: reports on the siren status*.
• Smoke Detector: reports on the smoke sensor status*.
• Smoke+CO Detector: reports on the smoke and carbon monoxide sensor status*.
• Water Sensor: reports on water sensor status*.

* Sensor status is only available for SimpliSafe V3 systems and is updated once every 30 seconds, so information displayed in Home Assistant may be delayed. For cases where the default pollingData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] interval of 30 seconds is too long for automations, enabling a secret alert in the SimpliSafe app will let Home Assistant automatically set the status to triggered for binary sensor devices that have secret alerts. However, due to the way SimpliSafe implements secret alerts, you can only receive push notifications when devices are triggered, not when they are cleared.

SimpliSafe Plans

SimpliSafe offers several monitoring plans. All plans (including the free plan) should work with this integration.

Configuration

To add the SimpliSafe hub to your Home Assistant instance, use this My button:

SimpliSafe can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Getting an Authorization Code

SimpliSafe authenticates users via its web app. Due to technical limitations, there is a manual step when adding the integration. For in-depth guidance, refer to step 6 of the simplisafe-python documentation on authentication.

List of actions

The SimpliSafe integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

• Remove PIN (simplisafe.remove_pin) Removes a SimpliSafe PIN by its label or value.

• Set PIN (simplisafe.set_pin) Sets or updates a SimpliSafe PIN.

• Set system properties (simplisafe.set_system_properties) Sets one or more properties on a SimpliSafe system.

For an overview of every action across all integrations, see the actions reference.

System events

Each SimpliSafe system provides a system event entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] that captures events from your security system with the following attributes:

• event_type, always one of the following:
  • Automatic test (automatic_test)
  • Device test (device_test)
  • Secret alert triggered (secret_alert_triggered)
  • Sensor paired and named (sensor_paired_and_named)
  • User initiated test (user_initiated_test).
• changed_by: The PIN that triggered the event (if applicable).
• info: A human-friendly string describing the event in more detail.
• sensor_name: The sensor that triggered the event (if applicable).
• sensor_serial: The serial number of the sensor that triggered the event (if applicable).
• sensor_type: The type of sensor that triggered the event (if applicable).

Automation example: detecting secret alert events

Home Assistant already uses SimpliSafe secret alerts as triggers to turn on binary sensors. However, if you want to manually listen for them or adapt this example to listen for another type of system event, you can do the following:

1. Enable the secret alert for the device in the SimpliSafe App.
2. Make a note of the serial number of the device.
   • You can see it in the top-left corner of the page where you set the alert.
3. Use the Event received trigger on your system event entity, with a condition to match the sensor serial:

triggers:
  - trigger: event.received
    target:
      entity_id: event.YOUR_SYSTEM_EVENTS_ENTITY
    options:
      event_type:
        - secret_alert_triggered
conditions:
  - condition: template
    value_template: "{{ trigger.to_state.attributes.sensor_serial == 'abc123xyz' }}"

Camera events

Each supported SimpliSafe camera (reports camera_motion_detected) and doorbell (reports doorbell_detected) also provides its own event entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more].

Automation example: doorbell notification

- alias: "Notify me when the doorbell rings"
  triggers:
    - trigger: event.received
      target:
        entity_id: event.YOUR_DOORBELL
  actions:
    - action: notify.send_message
      target:
        entity_id: notify.YOUR_PHONE
      data:
        message: "Someone is at the front door."

SIMPLISAFE_NOTIFICATION events

SIMPLISAFE_NOTIFICATION events represent system notifications that would appear in the messages section of the SimpliSafe web and mobile apps. When received, they come with event data that contains the following keys:

• category: The notification category (e.g., error)
• code: The SimpliSafe code for the notification
• message: The actual text of the notification
• timestamp: The UTC timestamp of the notification

Note that when Home Assistant restarts, SIMPLISAFE_NOTIFICATION events will fire once again for any notifications still active in the SimpliSafe web and mobile apps. To prevent this, either (a) clear them in the web/mobile app or (b) use the clear_notifications button provided by the alarm control panel.