Send SMS via Vonage (Nexmo)


MoEngage recommends you read how to create connector campaigns.  You can use connectors to send SMS using any SMS Service provider.

Marketers can use connectors to send SMS via any SMS Service provider. In this example, we will explain how to send SMS using Vonage SMS API.

Before creating the campaign, ensure you have following parameters for calls to Vonage API. You can find your Key and Secret in Vonage Dashboard. You can also read about Vonage SMS API here.

Parameter Description
api_key - Your Key. For example: api_key=n3xm0rocks
api_secret - Your Secret. For example: api_secret=12ab34cd

To create an SMS campaign, navigate to MoEngage Dashboard>Engage> Campaigns and click Create Campaign. Click Create in Connector Campaign.CreateCampaign.png

Step 1: 

Add a suitable name for your campaign (e.g. you are creating a campaign to send out SMS)


Choose the Sending Type as per your use case. Say you want to trigger a SMS to customers who have done a certain event but have not received/clicked the notification sent to them, choose sending type as At trigger event.

Choose the target audience once you have decided the sending type. You can target all the users or users who fulfill certain user criteria/behavior criteria.

Step 2:

Configure Web-hook URL (or Target Connector URL) . Choose GET/POST as suggested by your SMS API provider. We are quoting below example using SMS API of Vonage.

GET Method:

Screen_Shot_2017-05-30_at_4.03.02_PM.pngOnce you enter your API Request URL, you will be able to see the URL parameters here:


You can find your Key and Secret in Vonage Dashboard. . In to field, you can personalize [using @] it to select user's mobile number. Ensure that selected attribute consists of user's mobile numbers.

Replace From with sender Id of your account provided by Vonage. Configure the message that you would want to send in the text field above.

Note: Before sending SMS campaign to your users, please ensure that 2 or more active/installed users are not mapped to same Mobile Number. If they are, those users will receive multiple SMSs. You can avoid that by choosing Mobile Number as De-dup key in Step 3.


Once you are done with campaign, you will be take to campaign analytics page. Analytics will be generated with-in an hour from the time your campaign starts sending. 

Read more about campaign analytics.

Was this article helpful?
0 out of 0 found this helpful