RocketCOMS

Create a Brand

Create a new brand. The submitted brand will go through an Identity Verification process with The Campaign Registry (TCR) and the brand will be assigned a verification status of VERIFIED or UNVERIFIED. Once a brand is verified, campaigns can be registered for the brand.

Endpoint

POST /v1/brands

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

companyName  CONDITIONAL

string, max length: 255, min length: 0

Legal name of the business. Not required if entityType is SOLE_PROPRIETOR.

displayName  REQUIRED

string, max length: 255, min length: 0

Display or marketing name for the brand.

ein  CONDITIONAL

string, max length: 9, min length: 9

Employer Identification Number (EIN) assigned to the business. In the United States, an EIN contains 9 digits. Not required if entityType is SOLE_PROPRIETOR.

einIssuingCountry

string

ISO 2-letter country code for the country issuing the Employer Identification Number (EIN).

entityType

string (UUID)

Type of business for the brand. Use the List Brand Entity Types API to retrieve a list of alias values that can be used in this field.

vertical  CONDITIONAL

string

Industry segment for the brand. Not required if entityType is SOLE_PROPRIETOR. Use the List Verticals API to retrieve a list of verticalName values that can be used in this field.

website

string, max length: 100, min length: 0

pattern: ^(http:\/\/www\.|https:\/\/www\.|http:\/\/|https:\/\/)?[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,5}(:[0-9]{1,5})?(\/.*)?$

Website for the brand. Must include http:// or https://.

stockSymbol  CONDITIONAL

string, max length: 10, min length: 0

Stock symbol for the brand. Required if entityType is PUBLIC_PROFIT.

stockExchange  CONDITIONAL

string enum, values: NONE, NASDAQ, NYSE, AMEX, AMX, ASX, B3, BME, BSE, FRA, ICEX, JPX, JSE, KRX, LON, NSE, OMX, SEHK, SGX, SSE, STO, SWX, SZSE, TSX, TWSE, VSE, OTHER

Stock exchange for the brand. Required if entityType is PUBLIC_PROFIT.

firstName  CONDITIONAL

string, max length: 100, min length: 1

First name of the brand contact. Required if entityType is SOLE_PROPRIETOR.

lastName  CONDITIONAL

string, max length: 100, min length: 0

Last name of the brand contact. Required if entityType is SOLE_PROPRIETOR.

phone  REQUIRED

string, max length: 20, min length: 0

pattern: ^\+?[1-9]\d{1,14}$

Phone number (in E.164 format) for the brand support contact.

email  REQUIRED

string, max length: 100, min length: 0

Email address for the brand support contact.

street  REQUIRED

string, max length: 100, min length: 0

Street number and name.

city  REQUIRED

string, max length: 100, min length: 0

City.

state  REQUIRED

string, max length: 20, min length: 0

State or province. 2-character codes are required for the United States (for example, use CA for California).

postalCode  REQUIRED

string, max length: 10, min length: 0

Zip code or postal code. 5-digit zip codes are required for the United States.

country  REQUIRED

string, max length: 2, min length: 0

ISO 2-character country code. For example, use US for the United States.

brandRelationship  CONDITIONAL

string

Brand’s history with the CSP. Not required if entityType is SOLE_PROPRIETOR. Use the List Brand Relationships API to retrieve a list of alias values that can be used in this field.

Returns

Returns the brand details, including the brand status and a unique ID for the brand. For details, see the Brand object.

SAMPLE REQUEST

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

SAMPLE RESPONSE

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