Skip to main content
Version: Next

Home Assistant

Instructions on how you can use Secured Signal API as a notification service for Home Assistant.

Setup

1. Home Assistant Configuration

To be able to use the Signal Messenger integration in Home Assistant you need to modify or add the following to your configuration.yml file:

notify:
- name: signal
platform: signal_messenger
url: "http://api:API_TOKEN@sec-signal-api:8880"
number: "{{.NUMBER}}"
recipients:
- "+123400002" # tip: use a placeholder instead

tip

If you want to use a list of recipients as placeholder you have to inject the recipients field from the path into the body. For that, add /@recipients={{.RECIPIENTS}} at the of the url:

url: "http://api:API_TOKEN@sec-signal-api:8880/@recipients={{.RECIPIENTS}}"

Here we are taking advantage of the url field to implement Basic Auth by using user:password@host:port.

For more detailed configuration instructions read the official Home Assistant docs.

And that's basically it, have fun!

Sources