> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raven.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# MessageBird

> Guide on how to add MessageBird SMS Integration.

### Step 1. Account Setup

If you do not have an account with MessageBird yet, create an account
[here](https://dashboard.messagebird.com/en/sign-up).

### Step 2. MessageBird Integration in Raven

| Keys      | Details                                                                                                                                                                 |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `API Key` | API key for your account. Follow the steps [here](https://dashboard.messagebird.com/en/login) to create one.                                                            |
| `Sender`  | Sender id to be sent with the SMS. Follow the steps [here](https://support.messagebird.com/hc/en-us/articles/115002628665-Choosing-an-originator) to get your Sender ID |

***

### Step 3. Delivery Reports

Follow the steps to setup delivery reports:

1. On the Raven dashboard, once you successfully add the MessageBird
   Integration, you will see it in the "Live" tab. Go to the Live tab, and click
   on MessageBird SMS. You will see a URL as Status Webhook, present in the
   integration. Copy this URL.
2. Log in to MessageBird and go to
   [Delivery Reports](https://dashboard.messagebird.com/en/developers/settings).
3. Paste the Status Webhook URL copied in Step 1, in the Status reports URL and
   click on Save.

## Advanced

**Send additional parameters to MessageBird**

Raven sends the fields present in the SMS template to MessageBird by default. To
send additional fields, please check our [Override doc](/sms/sms-template).

**IP Whitelisting**

You can control access by specifying Raven's IP address, or make sure Raven's IP
addresses are whitelisted and not blocked.

IPs: 65.2.109.100, 65.2.58.233

## Links

* [MSG91 Website](https://www.messagebird.com/en/)
* [MSG91 SMS Documentation](https://developers.messagebird.com/api/sms-messaging/#sms-api)
* [MSG91 Console](https://dashboard.messagebird.com/en/login)​

​<Info> If you are facing issues with this integration or find something
missing, please write to us at [support@ravenapp.dev](mailto:support@ravenapp.dev) </Info>