Skip to main content
Version: v1.6

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​