RocketCOMS

Design  /  Brand Use Cases  /  Create a Brand

Create a Brand

Overview

In this use case, we’ll walk through creating a new brand and registering the brand with The Campaign Registry (TCR).

A brand is the company the end-user (the mobile subscriber) believes to be sending the SMS messages, and is responsible for the messaging content in a campaign.

API Operation

Steps

Call the following endpoint:

POST /v1/brands

  • Include details about the brand in the request body (company name, type of business, brand contact details, brand relationship, and so on). For a list of required fields, see the API Reference.
  • In the Authorization Header, include your RocketCOMS access token as a Bearer Token.

Sample Request

The following request would create a new brand for a public for-profit company.

				
					{
  "entityType": "PUBLIC_PROFIT",
  "firstName": "John",
  "lastName": "Doe",
  "displayName": "ABC Mobile",
  "companyName": "ABC Inc.",
  "ein": "111111111",
  "einIssuingCountry": "US",
  "phone": "+12024567890",
  "street": "123 6th Ave",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "johndoe@abc.com",
  "stockSymbol": "ABC",
  "stockExchange": "NASDAQ",
  "website": "http://www.abcmobile.com",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "RETAIL"
}

				
			

Sample Response

The Brand object is returned. This includes the TCR registration score, details about the brand creation, and the brand details.

				
					{
  "status": "0000",
  "result": {
    "id": "d7b0e25f-30c9-456b-b287-6b3dcaa4b8f7",
    "firstName": "John",
    "lastName": "Doe",
    "countryCode": "US",
    "stockExchange": "NASDAQ",
    "stockSymbol": "ABC",
    "entityType": "PUBLIC_PROFIT",
    "cspId": "4e0c15a5-d798-46ff-8c50-2b30bd597abf",
    "displayName": "ABC Mobile",
    "companyName": "ABC Inc.",
    "ein": "111111111",
    "einIssuingCountry": "US",
    "phone": "+12024567890",
    "street": "123 6th Ave",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US",
    "website": "http://www.abcmobile.com",
    "brandRelationship": "BASIC_ACCOUNT",
    "vertical": "RETAIL",
    "universalEin": "111111111",
    "registrationScore": 0,
    "lastStatus": "633eb3bb-7e78-447b-be04-e234dadfb629",
    "lastStatusAt": "2022-04-20T00:18:06.347Z",
    "businessAccountId": "67b25a5e-f90a-4491-9ee4-291ff290c1fe",
    "status": "ACTIVE",
    "email": "johndoe@abc.com",
    "createdAt": "2022-04-20T00:18:06.347Z",
    "rejectionReason": "string"
  }
}
				
			
ON THIS PAGE