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

# Twilio

# Introduction

Twilio is a customer engagement platform used by hundreds of thousands of businesses and more than ten million developers worldwide to build unique, personalized customer experiences.

<Info>
  **Prerequisites** You must have access to your Twilio dashboard.
</Info>

# Configure as SMS/MMS connector (Service Provider)

<Info>
  Twilio also supports MMS. You can follow the same procedure below to configure Twilio as your MMS sender.
</Info>

Below is a step-by-step explanation for setting up Twilio as your desired SMS/MMS provider on MoEngage. Before proceeding, ensure you have the login credentials for your Twilio account readily available. You can also reach out to the MoEngage Customer Success Management (CSM) team for assistance.

Log in to the MoEngage Dashboard and follow these steps:

1. Navigate to **Settings** > **Channel** > **SMS, MMS & RCS** > **Sender configuration**.
2. Click **+Add Service Provider** in the upper-right corner.
3. Select **Twilio** in the **Add Sender** screen.
4. When setting up your account for the first time, you must enter the authentication details. After you log in to your Twilio account, you can find the required details in your [Twilio console](https://console.twilio.com/?frameUrl=/console).
   * **Username**: This is the **Twilio Account SID**.
   * **Password**: This is the **Twilio Auth Token**. <img src="https://mintcdn.com/moengage/syqICryKE0qygh49/images/partner_21971989388692.png?fit=max&auto=format&n=syqICryKE0qygh49&q=85&s=9d82d3c21a5af68b624f4ac4f1388dd9" alt="Twilio_NewUI_Authentication.png" width="1148" height="594" data-path="images/partner_21971989388692.png" />
5. After entering the Twilio Account SID and Auth token, click **Save** to save the authentication details.\
   Twilio authentication is at the account level, and you do not need to add this for each sender. However, if you need to change the authentication parameters, you can click the "Reauthenticate" link next to Twilio and update the settings.

<img src="https://mintcdn.com/moengage/syqICryKE0qygh49/images/partner_21971996286868.png?fit=max&auto=format&n=syqICryKE0qygh49&q=85&s=e7b0dc3df22e7d8c0f79ff81c4ef8115" alt="Twilio_NewUI_ReAuthentication.png" width="402" height="98" data-path="images/partner_21971996286868.png" />

You can now configure the Twilio sender.

6. Add the following details in the **Sender Details** screen.

| Field                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mark as default**                     | This toggle will be disabled during sender creation. The first sender to be created in your MoEngage account will be marked as the default sender for your SMS campaigns. You can change the default sender by following the steps outlined in [Marking a sender as default](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/getting-started-with-sms/configure-an-sms-sender).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **This sender supports MMS**            | Select this checkbox to configure Twilio as an MMS sender.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Sender name**                         | This field identifies the readable sender name that can be used while creating a campaign or alert.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Sender type**                         | The sender type can be one of the following:<br />\* **Short Code**<br />\* **Long Code**<br />\* **Messaging Service**<br />\* **Alphanumeric Sender ID**<br />Select the appropriate sender type.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Sender ID**                           | This is the number from which SMS will be sent to your users. Ensure that you add the corresponding number for the type you selected. For more information, refer to [ShortCodes](https://console.twilio.com/us1/develop/sms/senders/short-codes?frameUrl=%2Fconsole%2Fsms%2Fshort-codes%3Fx-target-region%3Dus1), [LongCodes](https://console.twilio.com/us1/develop/phone-numbers/manage/active?frameUrl=%2Fconsole%2Fphone-numbers%2Fincoming%3Fx-target-region%3Dus1), and [MessagingServices.](https://console.twilio.com/us1/develop/sms/services?frameUrl=/console/sms/services)**Note** : When the Sender type is **Messaging Service** , enter the Messaging Service SID in the Sender ID field.                                                                                                                                                                                                                                                                               |
| **Mobile Originated (MO) callback URL** | This callback URL depends on the data center (DC) to which your workspace belongs. The following are the callback URLs: <ul><li>For DC 01: [https://api-01.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio](https://api-01.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio)</li><li>For DC 02: [https://api-02.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio](https://api-02.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio)</li><li>For DC 03: [https://api-03.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio](https://api-03.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio)</li><li>For DC 04: [https://api-04.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio](https://api-04.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio)<br /><br />Note that this field is only available when you enable the **Manage keyword based responses** toggle under **Keyword management**.</li></ul> |
| **SMS unsubscribe text**                | The input text provided in this field appears when you select the **SMS opt-out instruction** checkbox while creating content for your SMS campaign. The SMS opt-out instruction enables you to include a text in the created SMS campaign that allows your customers to opt out of receiving further SMS messages. Note that this field is only available when you enable the **Manage keyword based responses** toggle under **Keyword management**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

7. **Send a test SMS** to verify your configuration.
8. Click **Save** to save the Sender Configuration.
9. You can also check your account balance by clicking **Check balance**.

## Delivery Callback

For both long and short codes, MoEngage automatically tracks delivery receipts by passing the delivery callback URL in the API call to Twilio. You don't need to perform any additional configuration to track SMS delivery.

For Messaging Services, you need to add the Delivery Callback URL in the Twilio dashboard for each messaging service. To do this:

1. Log in to your Twilio Dashboard.
2. Go to **Messaging** > **Services**.

<img src="https://mintcdn.com/moengage/V7W8fvZbxtTmKTAn/images/partner_11468751356180.png?fit=max&auto=format&n=V7W8fvZbxtTmKTAn&q=85&s=97ab3f94b1ce093ffe4bef472dbb00da" alt="Twilio_MessagingServices.png" width="1392" height="403" data-path="images/partner_11468751356180.png" />

3. Select a Messaging service. You will see a different menu on the left panel.
4. Click the **Integration** tab under the Messaging service name. Scroll to **Delivery Status Callback** and enter the Callback URL - *[https://api-01.moengage.com/sms/dlr/twilio](https://api-01.moengage.com/sms/dlr/twilio).*

<img src="https://mintcdn.com/moengage/V7W8fvZbxtTmKTAn/images/partner_11468752701332.png?fit=max&auto=format&n=V7W8fvZbxtTmKTAn&q=85&s=e7efa44328b45c0d6ae139171a275969" alt="Twilio_Integration.png" width="1173" height="621" data-path="images/partner_11468752701332.png" />

# Configure Content Settings

When configuring Twilio as your MMS sender, you must enable the MMS Converter in the Twilio dashboard. This allows you to send outbound MMS messages to destinations that don't support the format. For these messages, the MMS Converter replaces the attached media with a short URL in the message body that links to the file. Perform the following steps to enable this setting:

1. Log in to the Twilio console.
2. Navigate to the messaging service that needs to be configured, and click **Content Settings**.
3. Turn on the **MMS Converter** toggle.

<img src="https://mintcdn.com/moengage/Q5fGPh1IanYG_0OI/images/partner_42712122553108.png?fit=max&auto=format&n=Q5fGPh1IanYG_0OI&q=85&s=2fdd6aed88e59fa6b00fb59f6c28bb97" alt="Screenshot 2025-09-16 at 4.54.49 PM.png" width="2880" height="1352" data-path="images/partner_42712122553108.png" />

# Configure Keyword Management

This section describes how to configure keyword management.

## Changes in MoEngage Settings

To configure keyword management, you must enter the following two fields in the **Sender Details** screen of the MoEngage dashboard. These fields appear only when you enable the **Manage keyword-based responses** toggle under **Keyword management**.

<img src="https://mintcdn.com/moengage/cJSG0nHne5L3-Q_X/images/partner_30862038839444.png?fit=max&auto=format&n=cJSG0nHne5L3-Q_X&q=85&s=6f61c6a22feaf94e1b35e6f595fea28d" alt="image (2)n.png" width="2308" height="1320" data-path="images/partner_30862038839444.png" />

* **Mobile Originated (MO) callback URL**: This callback URL depends on the DC you belong to. The following are the callback URLs:
  * For DC 01 - [https://api-01.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio](https://api-01.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio)
  * For DC 02 - [https://api-02.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio](https://api-02.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio)
  * For DC 03 - [https://api-03.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio](https://api-03.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio)
  * For DC 04 - [https://api-04.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio](https://api-04.moengage.com/v1/campaigns/outbound/sms/callbacks/mo/twilio)
* **SMS unsubscribe text**: The SMS unsubscribe text allows you to include a text in the created SMS campaign that helps your customers opt out of further SMS messages. The input text provided in this field is displayed as an opt-out text when you select the **SMS opt-out instruction** checkbox while creating content for your SMS campaign.

## Changes in Twilio Console

For any configured sender, perform the following steps to configure key management in the Twilio console:

1. Log in to the Twilio console.
2. Navigate to the messaging service that needs to be configured, and click **Integration**.

<img src="https://mintcdn.com/moengage/cJSG0nHne5L3-Q_X/images/partner_30862023360148.png?fit=max&auto=format&n=cJSG0nHne5L3-Q_X&q=85&s=8e4d21e5d7814fb9665676ecfa072c3a" alt="twilio.png" width="2366" height="1300" data-path="images/partner_30862023360148.png" />

3. Under **Incoming Messages**, select **Send a webhook**.
4. In the **Request URL** field, enter the same callback URL you added in the **Mobile Originated (MO) callback URL** field of the MoEngage dashboard.
5. Select the method as **HTTP Get**.

# Next Steps

* Create an SMS campaign using the [Getting Started for creating SMS campaign](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/create-an-sms-campaign).
* Set the [Frequency Capping for SMS](/docs/user-guide/settings/channels/delivery-controls/frequency-capping).
* Set the [Current Service Provider](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/getting-started-with-sms/configure-an-sms-sender).