Create Brand

POST 
/brand

This endpoint is used to create a new brand. A brand is an entity created by The Campaign Registry (TCR) that represents an organization or a company. It is this entity that TCR created campaigns will be associated with. Each brand creation will entail an upfront, non-refundable $4 expense.

application/json

Body

required

entityType EntityTyperequired

Possible values: [PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, SOLE_PROPRIETOR, GOVERNMENT]

Entity type behind the brand. This is the form of business establishment.

displayName Displayname (string)required

Possible values: <= 100 characters

Display name, marketing name, or DBA name of the brand.

companyName Companyname (string)

Possible values: <= 100 characters

(Required for Non-profit/private/public) Legal company name.

firstName Firstname (string)

Possible values: <= 100 characters

First name of business contact.

lastName Lastname (string)

Possible values: <= 100 characters

Last name of business contact.

ein Ein (string)

Possible values: <= 20 characters

(Required for Non-profit) Government assigned corporate tax ID. EIN is 9-digits in U.S.

phone Phone (string)

Possible values: <= 20 characters

Valid phone number in e.164 international format.

street Street (string)

Possible values: <= 100 characters

Street number and name.

city City (string)

Possible values: <= 100 characters

City name

state State (string)

Possible values: <= 20 characters

State. Must be 2 letters code for United States.

postalCode Postalcode (string)

Possible values: <= 10 characters

Postal codes. Use 5 digit zipcode for United States

country Country (string)required

Possible values: <= 2 characters

ISO2 2 characters country code. Example: US - United States

email Email (string)required

Possible values: <= 100 characters

Valid email address of brand support contact.

stockSymbol Stocksymbol (string)

Possible values: <= 10 characters

(Required for public company) stock symbol.

stockExchange StockExchange

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

(Required for public company) stock exchange.

ipAddress Ipaddress (string)

Possible values: <= 50 characters

IP address of the browser requesting to create brand identity.

website Website (string)

Possible values: <= 100 characters

Brand website URL.

vertical Verticalrequired

Possible values: [REAL_ESTATE, HEALTHCARE, ENERGY, ENTERTAINMENT, RETAIL, AGRICULTURE, INSURANCE, EDUCATION, HOSPITALITY, FINANCIAL, GAMBLING, CONSTRUCTION, NGO, MANUFACTURING, GOVERNMENT, TECHNOLOGY, COMMUNICATION]

Vertical or industry segment of the brand or campaign.

isReseller Isreseller (boolean)
mock Mock (boolean)

Mock brand for testing purposes. Defaults to false.

mobilePhone Mobilephone (string)

Possible values: <= 20 characters

Valid mobile phone number in e.164 international format.

businessContactEmail BusinessContactEmail (string)

Business contact email.

Required if entityType is PUBLIC_PROFIT.

webhookURL WebhookURL (string)

Webhook URL for brand status updates.

webhookFailoverURL WebhookFailoverURL (string)

Webhook failover URL for brand status updates.

200: Successful Response

application/json

• Schema
• Example (from schema)

Schema

entityType EntityTyperequired

Possible values: [PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, SOLE_PROPRIETOR, GOVERNMENT]

Entity type behind the brand. This is the form of business establishment.

cspId Cspid (string)

Unique identifier assigned to the csp by the registry.

brandId Brandid (string)

Unique identifier assigned to the brand.

tcrBrandId TcrBrandid (string)

Unique identifier assigned to the brand by the registry.

displayName Displayname (string)required

Possible values: <= 100 characters

Display or marketing name of the brand.

companyName Companyname (string)

Possible values: <= 100 characters

(Required for Non-profit/private/public) Legal company name.

firstName Firstname (string)

Possible values: <= 100 characters

First name of business contact.

lastName Lastname (string)

Possible values: <= 100 characters

Last name of business contact.

ein Ein (string)

Possible values: <= 20 characters

(Required for Non-profit) Government assigned corporate tax ID. EIN is 9-digits in U.S.

phone Phone (string)

Possible values: <= 20 characters

Valid phone number in e.164 international format.

street Street (string)

Possible values: <= 100 characters

Street number and name.

city City (string)

Possible values: <= 100 characters

City name

state State (string)

Possible values: <= 20 characters

State. Must be 2 letters code for United States.

postalCode Postalcode (string)

Possible values: <= 10 characters

Postal codes. Use 5 digit zipcode for United States

country Country (string)required

Possible values: <= 2 characters

ISO2 2 characters country code. Example: US - United States

email Email (string)required

Possible values: <= 100 characters

Valid email address of brand support contact.

stockSymbol Stocksymbol (string)

Possible values: <= 10 characters

(Required for public company) stock symbol.

stockExchange StockExchange

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

(Required for public company) stock exchange.

ipAddress Ipaddress (string)

Possible values: <= 50 characters

IP address of the browser requesting to create brand identity.

website Website (string)

Possible values: <= 100 characters

Brand website URL.

brandRelationship BrandRelationshiprequired

Possible values: [BASIC_ACCOUNT, SMALL_ACCOUNT, MEDIUM_ACCOUNT, LARGE_ACCOUNT, KEY_ACCOUNT]

Brand relationship to the CSP.

vertical Vertical (string)required

Possible values: <= 50 characters

Vertical or industry segment of the brand.

altBusinessId Altbusinessid (string)

Possible values: <= 50 characters

Alternate business identifier such as DUNS, LEI, or GIIN

altBusinessIdType AltBusinessIdType

Possible values: [NONE, DUNS, GIIN, LEI]

An enumeration.

universalEin Universalein (string)

Universal EIN of Brand, Read Only.

referenceId Referenceid (string)

Unique identifier Telnyx assigned to the brand - the brandId

identityStatus BrandIdentityStatus

Possible values: [VERIFIED, UNVERIFIED, SELF_DECLARED, VETTED_VERIFIED]

The verification status of an active brand

optionalAttributes

object

taxExemptStatus Taxexemptstatus (string)

The tax exempt status of the brand

mock Mock (boolean)

Mock brand for testing purposes

mobilePhone Mobilephone (string)

Possible values: <= 20 characters

Valid mobile phone number in e.164 international format.

isReseller Isreseller (boolean)

Indicates whether this brand is known to be a reseller

webhookURL WebhookURL (string)

Webhook to which brand status updates are sent.

businessContactEmail BusinessContactEmail (string)

Business contact email.

Required if entityType is PUBLIC_PROFIT.

webhookFailoverURL WebhookFailoverURL (string)

Failover webhook to which brand status updates are sent.

createdAt string

Date and time that the brand was created at.

updatedAt string

Date and time that the brand was last updated at.

status status

Possible values: [OK, REGISTRATION_PENDING, REGISTRATION_FAILED]

Status of the brand

failureReasons failureReasons

Failure reasons for brand

{
  "entityType": "PRIVATE_PROFIT",
  "cspId": "string",
  "brandId": "4b20017f-8da9-a992-a6c0-683072fb7729",
  "tcrBrandId": "BBRAND1",
  "displayName": "ABC Mobile",
  "companyName": "ABC Inc.",
  "firstName": "John",
  "lastName": "Smith",
  "ein": "111111111",
  "phone": "+12024567890",
  "street": "123",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "string",
  "stockSymbol": "ABC",
  "stockExchange": "NASDAQ",
  "ipAddress": "string",
  "website": "http://www.abcmobile.com",
  "vertical": "string",
  "altBusinessId": "string",
  "universalEin": "string",
  "referenceId": "string",
  "optionalAttributes": {
    "taxExemptStatus": "string"
  },
  "mock": false,
  "mobilePhone": "+12024567890",
  "isReseller": false,
  "webhookURL": "https://webhook.com/67ea78a8-9f32-4d04-b62d-f9502e8e5f93",
  "businessContactEmail": "name@example.com",
  "webhookFailoverURL": "string",
  "createdAt": "2021-03-08T17:57:48.801186",
  "updatedAt": "2021-03-08T17:57:48.801186"
}

422: Validation Error

application/json

• Schema
• Example (from schema)

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

• MOD1
• MOD2

string

integer

]

msg Message (string)required

type Error Type (string)required

]

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/10dlc/brand' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "entityType": "PRIVATE_PROFIT",
  "displayName": "ABC Mobile",
  "companyName": "ABC Inc.",
  "firstName": "John",
  "lastName": "Smith",
  "ein": "111111111",
  "phone": "+12024567890",
  "street": "123",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "string",
  "stockSymbol": "ABC",
  "stockExchange": "NASDAQ",
  "ipAddress": "string",
  "website": "http://www.abcmobile.com",
  "vertical": "TECHNOLOGY",
  "isReseller": false,
  "mock": false,
  "mobilePhone": "+12024567890",
  "businessContactEmail": "name@example.com",
  "webhookURL": "https://webhook.com/67ea78a8-9f32-4d04-b62d-f9502e8e5f93",
  "webhookFailoverURL": "https://webhook.com/9010a453-4df8-4be6-a551-1070892888d6"
}'

Response samples

• 200
• 422

---

{
  "entityType": "PRIVATE_PROFIT",
  "cspId": "string",
  "brandId": "4b20017f-8da9-a992-a6c0-683072fb7729",
  "tcrBrandId": "BBRAND1",
  "displayName": "ABC Mobile",
  "companyName": "ABC Inc.",
  "firstName": "John",
  "lastName": "Smith",
  "ein": "111111111",
  "phone": "+12024567890",
  "street": "123",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "string",
  "stockSymbol": "ABC",
  "stockExchange": "NASDAQ",
  "ipAddress": "string",
  "website": "http://www.abcmobile.com",
  "vertical": "string",
  "altBusinessId": "string",
  "universalEin": "string",
  "referenceId": "string",
  "optionalAttributes": {
    "taxExemptStatus": "string"
  },
  "mock": false,
  "mobilePhone": "+12024567890",
  "isReseller": false,
  "webhookURL": "https://webhook.com/67ea78a8-9f32-4d04-b62d-f9502e8e5f93",
  "businessContactEmail": "name@example.com",
  "webhookFailoverURL": "string",
  "createdAt": "2021-03-08T17:57:48.801186",
  "updatedAt": "2021-03-08T17:57:48.801186"
}

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}