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.
POST /v1/brands
Authorization: Bearer <access_token>
or
Authorization: Basic <encodedString>
where <encodedString> is your <api-key>:<api-secret> string encoded using Base64 encoding
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 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"
}
}
© 2023 Rocket Financial. All rights reserved. RocketFNCL, RocketKOR, RocketBNK are trade names of Rocket Financial Inc.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL
© 2023 by Rocket Financial Inc. All rights reserved.