home-assistant.io/source/_integrations/sinch.markdown

title	description	ha_category	ha_release	ha_codeowners	ha_domain	ha_iot_class	ha_platforms	ha_integration_type	related	ha_quality_scale
Sinch SMS	Instructions on how to add Sinch notifications to Home Assistant.	Notifications	0.101	@bendikrb	sinch	Cloud Push	notify	integration	docs title /docs/configuration/ Configuration file	legacy

The sinch {% term integration %} uses Sinch to deliver notifications from Home Assistant.

Prerequisites

Go to your Sinch Dashboard and click "Add new REST API". You should now be able to obtain your service_plan_id and api_key.

Configuration

To add Sinch to your installation, add the following to your Home Assistant {% term "configuration.yaml" %} file. {% include integrations/restart_ha_after_config_inclusion.md %}

# Example configuration.yaml entry
notify:
  - platform: sinch
    service_plan_id: SINCH_SERVICE_PLAN_ID
    api_key: SINCH_API_KEY

{% configuration %} name: description: "Setting the optional parameter name allows multiple notifiers to be created. The default value is Sinch. The notifier will bind to the notify.NOTIFIER_NAME action." required: false type: string service_plan_id: description: Your Sinch Service Plan ID. required: true type: string api_key: description: Your API Token. required: true type: string default_recipient: description: "A single or multiple phone numbers. This is where you want to send your SMS notification messages by default (when not specifying target in the action), e.g., 09171234567 or [09171234567, 09177654321]." required: false type: [string, list] sender: description: The name or number of the sender. required: false type: string default: 'Home Assistant' {% endconfiguration %}

To use notifications, please see the getting started with automation page.

Full configuration example

# Example configuration.yaml entry
notify:
  - platform: sinch
    name: Sinch
    service_plan_id: SINCH_SERVICE_PLAN_ID
    api_key: SINCH_API_KEY
    default_recipient: [PHONE_NO1, PHONE_NO2]
    sender: Home Assistant