Twilio SMS

The twilio notification platform enables sending notifications via SMS, powered by Twilio.

To use this notification platform in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
    platform: twilio_sms
    account_sid: ACCOUNT_SID_FROM_TWILIO
    auth_token: AUTH_TOKEN_FROM_TWILIO
    from_number: E164_PHONE_NUMBER

Configuration variables:

  • account_sid (Required): Your Twilio Account SID which can be found in your console. It starts with the letters AC.
  • auth_token (Required): Your Twilio Account SID which can be found in your console. It should be directly under where you found the account_sid.
  • from_number (Required): An E.164 formatted phone number, like +14151234567. See Twilio’s guide to formatting phone numbers for more information.
  • name (Optional): Setting the optional parameter name allows multiple notifiers to be created. The default value is notify. The notifier will bind to the service notify.NOTIFIER_NAME.


Twilio is a notify platform and thus can be controlled by calling the notify service as described here. It will send a notification to all E.164 phone numbers in the notification target. See the notes above regarding the from_number configuration variable for information about formatting phone numbers.

# Example automation notification entry
  - alias: The sun has set
      platform: sun
      event: sunset
      service: notify.twilio_sms
        message: 'The sun has set'
          - +14151234567
          - +15105555555