RocketCOMS

Create a Campaign

Create a new campaign for a registered brand. If the submitted campaign meets the requirements for at least one MNO, the campaign will be registered with the The Campaign Registry (TCR). Standard use case campaigns are approved upon submission while some special use case campaigns require manual approval by MNOs.

Endpoint

POST /v1/campaigns

Authorization Header

Authorization: Bearer <access_token>
or
Authorization: Basic <encodedString>
where <encodedString> is your <api-key>:<api-secret> string encoded using Base64 encoding

Request Body

brandId  REQUIRED

string (UUID)

Unique ID for the brand associated with the campaign.

campaignName  REQUIRED

string, max length: 255, min length: 0

Campaign name.

description  REQUIRED

string, max length: 4096, min length: 40

Detailed description of the campaign.

sender

string

pattern: ^(0|[1-9][0-9]*)$

10DLC phone number used to send SMS messages. Must be 11 digits.

usecase  REQUIRED

string (UUID)

Campaign use case. Use the List Use Cases API to retrieve a list of usecaseName values that can be used in this field.

subUsecases

array of strings (UUID)

Campaign sub use cases. Use the List Use Cases API to retrieve a list of usecaseName values that can be used in this field.

embeddedLink  REQUIRED

boolean, default: false

Whether the message generated by the campaign includes a URL link. Note that public URL shorteners (bityly, tinyurl) are not accepted.

embeddedPhone  REQUIRED

boolean, default: false

Whether the message generated by the campaign includes a phone number (other than the required HELP information contact phone number).

numberPool  REQUIRED

boolean, default: false

Whether the campaign utilizes a pool of phone numbers.

ageGated  REQUIRED

boolean, default: false

Whether the campaign includes any age-gated message content.

directLending  REQUIRED

boolean, default: false

Whether the campaign includes any message content related to direct lending or other loan arrangements.

subscriberOptin  REQUIRED

boolean, default: true

Whether the campaign requires the subscriber to opt-in before messages can be sent to the subscriber.

subscriberOptout  REQUIRED

boolean, default: false

Whether the campaign supports subscriber opt-out keyword(s).

subscriberHelp  REQUIRED

boolean, default: true

Whether the campaign responds to help keyword(s).

affiliateMarketing

boolean, default: false

Whether the message content is controlled by any affiliate marketing other than the brand.

mnoIds

array of strings

List of MNO network IDs for the MNOs the campaign will be submitted to. Default is all MNOs if no value is provided.

messageFlow  REQUIRED

string, max length: 2048, min length: 40

Message describing how a subscriber can opt-in to the campaign.

helpMessage  REQUIRED

string, max length: 255, min length: 0

Help message for the campaign.

optinMessage

string, max length: 320, min length: 20

Opt-in message shown to subscribers.

optoutMessage  REQUIRED

string, max length: 320, min length: 20

Opt-out message shown to subscribers.

autoRenewal

boolean, default: true

Whether the campaign subscription will automatically renew at the end of the billing cycle.

sample1

string, max length: 1024, min length: 20

Message sample. Some campaign tiers require up to 5 message samples.

sample2

string, max length: 1024, min length: 20

Message sample. Some campaign tiers require up to 5 message samples.

sample3

string, max length: 1024, min length: 20

Message sample. Some campaign tiers require up to 5 message samples.

sample4

string, max length: 1024, min length: 20

Message sample. Some campaign tiers require up to 5 message samples.

sample5

string, max length: 1024, min length: 20

Message sample. Some campaign tiers require up to 5 message samples.

Returns

Returns the campaign details, including the campaign status and a unique ID for the campaign. For details, see the Campaign object.

SAMPLE REQUEST

				
					{
  "brandId": "d7b0e25f-30c9-456b-b287-6b3dcaa4b8f7",
  "campaignName": "Spring Campaign",
  "description": "Spring Campaign",
  "sender": "12345678912",
  "usecase": "MARKETING",
  "embeddedLink": false,
  "embeddedPhone": false,
  "numberPool": false,
  "ageGated": false,
  "directLending": false,
  "subscriberOptin": true,
  "subscriberOptout": true,
  "subscriberHelp": true,
  "affiliateMarketing": false,
  "mnoIds": [
     "10017"
  ],
  "messageFlow": "string",
  "helpMessage": "Contact us at 1-800-123-1234 for assistance. To unsubscribe, reply STOP.",
  "optinMessage": "Do you want to receive messages about upcoming events? To consent, please reply YES.",
  "optoutMessage": "To stop receiving messages, please reply END.",
  "autoRenewal": true,
  "sample1": "Sample message",
  "sample2": "Sample message",
  "sample3": "Sample message",
  "sample4": "Sample message",
  "sample5": "Sample message"
}
				
			

SAMPLE RESPONSE

				
					{
  "status": "0000",
  "result": {
    "campaignName": "Spring Campaign",
    "description": "string",
    "sender": "12345678912",
    "usecase": "MARKETING",
    "subUsecases": [
      ""
    ],
    "embeddedLink": false,
    "embeddedPhone": false,
    "numberPool": false,
    "ageGated": false,
    "directLending": false,
    "subscriberOptin": true,
    "subscriberOptout": true,
    "subscriberHelp": true,
    "affiliateMarketing": "false",
    "mnoIds": [
      "10017"
    ],
    "messageFlow": "string",
    "helpMessage": "Contact us at 1-800-123-1234 for assistance. To unsubscribe, reply STOP.",
    "optinMessage": "To receive messages about upcoming events, reply YES.",
    "optoutMessage": "To unsubscribe, reply STOP.",
    "autoRenewal": true,
    "sample1": "string",
    "sample2": "string",
    "sample3": "string",
    "sample4": "string",
    "sample5": "string",
    "id": "d7b0e25f-30c9-456b-b287-6b3dcaa4b8f7",
    "businessAccountId": "67b25a5e-f90a-4491-9ee4-291ff290c1fe",
    "cspId": "4e0c15a5-d798-46ff-8c50-2b30bd597abf",
    "brandId": "d7b0e25f-30c9-456b-b287-6b3dcaa4b8f7",
    "status": "ACTIVE",
    "lastStatusAt": "2022-04-23T22:52:52.590Z",
    "createdAt": "2022-04-23T22:52:52.590Z",
    "billedDate": "2022-04-23T22:52:52.590Z",
    "endDateTime": "2022-04-23T22:52:52.590Z",
    "rejectionReason": "string",
    "batchMessageCount": 1000,
    "singleMessageCount": 200
  }
}