Initiate Subscription (API)

This document will detail how to initiate a subscription via RESTFul api.

To initiate a subscription via our RESTFul API you must make the following POST request:

Request

https://subscription-api.mobivate.com/subscriptions/v1/<campaign_id>/initiate

JSON Body

{
    "msisdn":"xxxxxxxxxxx"
    "signature":"xxxxxxxxxxxxxxxxxx"
    "keyword":"xxxxxxxx"
    "pin":"1234"
}

Parameters

Parameter	Description
msisdn	The unique MSISDN you are trying to unsubscribe.
signature	Unique parameter consisting of three values: campaign_id, msisdn and account_id. For example: 1af289e14aa593c843da7cd869a8e2f7.
keyword	Your unique Mobivate keyword.
pin	Your validated PIN code. For example: 12345.

Successful response

If your initiate subscription was successful, you will receive a HTTP Status Code: 200:

{
  "authenticated" : True,
  "valid_msisdn" : True,
  "valid_campaign" : True,
  "campaign_status" : "active",
  "campaign_name" : "Test Campaign",
  "campaign_service" : "12345",
  "state" : "pending_pin",
  "error" : Null,
  "reference": "AP:aaaaaaa-bbbbbbbbb-cccccccc"
}

Failed response

In case the campaign id is invalid or campaign is no longer available, the following status will be returned, HTTP Status Code: 404:

{
  "authenticated" : True,
  "valid_msisdn" : True,
  "valid_campaign" : False,
  "campaign_status" : Null,
  "campaign_name" : Null,
  "campaign_service" : Null,
  "state" : Null,
  "error" : "CampaignID '...' not found!",
  "reference": "AP:aaaaaaa-bbbbbbbbb-cccccccc"
}

Additional parameters/User Information

When submitting the subscription initiate response, you can also submit additional information that you have obtained about the subscriber. Here is a list of some of the additional parameters you can submit:

Parameter	Description
first_name	First Name
last_name	Last Name
email	Valid Email Address
dob	Date of birth
ip	Valid IPv4 Address
handset	Device/Make/Model/ID
custom_data	Any custom data in JSON format. Under 1kb
traffic_source	A name/ID to identify this traffic source