Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the

MSG91 Destination


MSG91(link takes you to an external page) provides SMS marketing/transactional automation for businesses. With Segment you can send SMS with a single call.

This destination is maintained by MSG91. For any issues with the destination, contact the MSG91 Support team.

(new)

This document is about a feature in beta

This means the feature is actively being developed, and some functionality may change before it becomes generally available.


Getting Started

getting-started page anchor
  1. From your Segment UI's Destinations page click on "Add Destination".
  2. Search for "MSG91" in the Catalog, select it, and choose which of your sources to connect the destination to.
  3. Enter the "API Key" into your Segment Settings UI which you can find from your MSG91 dashboard(link takes you to an external page) in the API page using the 'API' option in the sidebar. It's recommended that you create a brand new API key for the Segment destination.

If you're not familiar with the Segment Specs, take a look to understand what the Identify method does. An example call would look like:

1
{
2
"messageId": "test-message-7krupg",
3
"timestamp": "2019-04-16T06:33:14.682Z",
4
"type": "identify",
5
"email": "test@example.org",
6
"traits": {
7
"phone": "phone number to send SMS on",
8
"firstName": "Firstname of SMS receiver",
9
"message": "Thank you for singup, this is test SMS",
10
"senderID": "Ex. flipKT, MSGIND, Vodaphn"
11
},
12
"userId": "test-user-0md4g"
13
}

Identify calls will be sent to MSG91 as an Send SMS event.


If you're not familiar with the Segment Specs, take a look to understand what the Page method does. Make sure you send the following Properties with page method to send SMS. An example call would look like:

1
{
2
"type": "page",
3
"name": "Home",
4
"properties": {
5
"phone": "Phone number to send SMS",
6
"firstName": "John",
7
"message": "Thank you for singup, this is test SMS",
8
"senderID": "Ex. flipKT, MSGIND, Vodaph"
9
}
10
}
11

Page calls will be sent to MSG91 as a Send SMS.


If you're not familiar with the Segment Specs, take a look to understand what the Screen method does. Make sure you send the following Properties with Screen method to send SMS. An example call would look like:

1
{
2
"type": "screen",
3
"name": "Home",
4
"properties": {
5
"phone": "Phone number to send SMS",
6
"firstName": "John",
7
"message": "Thank you for singup, this is test SMS",
8
"senderID": "Ex. flipKT, MSGIND, Vodaph"
9
}
10
}

Screen calls will be sent to MSG91 as a Send SMS.


If you're not familiar with the Segment Specs, take a look to understand what the Track method does. Make sure you send the following Properties with track method to send SMS. An example call would look like:

1
{
2
"type": "track",
3
"event": "Clicked Login Button",
4
"properties": {
5
"phone": "Phone number to send SMS",
6
"firstName": "John",
7
"message": "Thank you for singup, this is test SMS",
8
"senderID": "Ex. flipKT, MSGIND, Vodaph"
9
}
10
}

Track calls will be sent to MSG91 as a Send SMS event.


You can check MSG91's API doc(link takes you to an external page) to read more about APIs and also test and create API from there.

Not seeing events?

not-seeing-events page anchor

Make sure you send the following properties/ traits to send SMS.

1
"properties": {
2
"phone": "Phone number to send SMS",
3
"firstName": "John",
4
"message": "Thank you for singup, this is test SMS",
5
"senderID": "Ex. flipKT, MSGIND, Vodaph"
6
},
Property/ TraitTypeDescription
phoneNumberPhone number with country code, on which you want to send SMS: 167554321, 918818888758
firstNameStringFirst name of SMS receiver
messageStringSMS content you want to get delivered on mobile number.
senderIDStringIdentity which will display on mobile when SMS received. Also dependent upon country rule(link takes you to an external page)

For more parameters, visit MSG91 API doc(link takes you to an external page)