The MessageBird notification platform sends notifications as SMS messages using MessageBird to your mobile phone.

To enable MessageBird notifications in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
    platform: message_bird
    api_key: YOUR_API_KEY

Configuration variables:

  • api_key (Required): Enter the API key for MessageBird. Go to to retrieve your API key.
  • 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.
  • sender (Optional): Setting the optional parameter sender. This will be the sender of the SMS. It may be either a telephone number (e.g., +4915112345678) or a text with a maximum length of 11 characters. Defaults to HA.


MessageBird is a notify platform and thus can be controlled by calling the notify service as described here. It will send a notification to the specified mobile phone number(s).

Example service payload

  "message": "A message for many people",
  "target": [ "+49123456789", "+43123456789" ]