Skip to main content
POST
/
brand
JavaScript
import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: 'My API Key',
});

const telnyxBrand = await client.brand.create({
  country: 'US',
  displayName: 'ABC Mobile',
  email: 'email',
  entityType: 'PRIVATE_PROFIT',
  vertical: 'TECHNOLOGY',
});

console.log(telnyxBrand.identityStatus);
{
  "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",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "<string>",
  "altBusinessId": "<string>",
  "altBusinessIdType": "NONE",
  "universalEin": "<string>",
  "referenceId": "<string>",
  "identityStatus": "VERIFIED",
  "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",
  "status": "OK",
  "failureReasons": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
entityType
enum<string>
required

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

Available options:
PRIVATE_PROFIT,
PUBLIC_PROFIT,
NON_PROFIT,
GOVERNMENT
Example:

"PRIVATE_PROFIT"

​
displayName
string
required

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

Maximum length: 100
Example:

"ABC Mobile"

​
country
string
required

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

Maximum length: 2
Example:

"US"

​
email
string
required

Valid email address of brand support contact.

Maximum length: 100
​
vertical
enum<string>
required

Vertical or industry segment of the brand. Vertical or industry segment of the brand or campaign.

Available options:
REAL_ESTATE,
HEALTHCARE,
ENERGY,
ENTERTAINMENT,
RETAIL,
AGRICULTURE,
INSURANCE,
EDUCATION,
HOSPITALITY,
FINANCIAL,
GAMBLING,
CONSTRUCTION,
NGO,
MANUFACTURING,
GOVERNMENT,
TECHNOLOGY,
COMMUNICATION
Example:

"TECHNOLOGY"

​
companyName
string

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

Maximum length: 100
Example:

"ABC Inc."

​
firstName
string

First name of business contact.

Maximum length: 100
Example:

"John"

​
lastName
string

Last name of business contact.

Maximum length: 100
Example:

"Smith"

​
ein
string

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

Maximum length: 20
Example:

"111111111"

​
phone
string

Valid phone number in e.164 international format.

Maximum length: 20
Example:

"+12024567890"

​
street
string

Street number and name.

Maximum length: 100
Example:

"123"

​
city
string

City name

Maximum length: 100
Example:

"New York"

​
state
string

State. Must be 2 letters code for United States.

Maximum length: 20
Example:

"NY"

​
postalCode
string

Postal codes. Use 5 digit zipcode for United States

Maximum length: 10
Example:

"10001"

​
stockSymbol
string

(Required for public company) stock symbol.

Maximum length: 10
Example:

"ABC"

​
stockExchange
enum<string>

(Required for public company) stock exchange.

Available options:
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
Example:

"NASDAQ"

​
ipAddress
string

IP address of the browser requesting to create brand identity.

Maximum length: 50
​
website
string

Brand website URL.

Maximum length: 100
Example:

"http://www.abcmobile.com"

​
isReseller
boolean
default:false
​
mock
boolean
default:false

Mock brand for testing purposes. Defaults to false.

​
mobilePhone
string

Valid mobile phone number in e.164 international format.

Maximum length: 20
Example:

"+12024567890"

​
businessContactEmail
string

Business contact email.

Required if entityType is PUBLIC_PROFIT. Otherwise, it is recommended to either omit this field or set it to null.

Example:

"name@example.com"

​
webhookURL
string

Webhook URL for brand status updates.

Example:

"https://webhook.com/67ea78a8-9f32-4d04-b62d-f9502e8e5f93"

​
webhookFailoverURL
string

Webhook failover URL for brand status updates.

Example:

"https://webhook.com/9010a453-4df8-4be6-a551-1070892888d6"

Response

Successful Response

Telnyx-specific extensions to The Campaign Registry's Brand type

​
entityType
enum<string>
required

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

Available options:
PRIVATE_PROFIT,
PUBLIC_PROFIT,
NON_PROFIT,
GOVERNMENT
Example:

"PRIVATE_PROFIT"

​
displayName
string
required

Display or marketing name of the brand.

Maximum length: 100
Example:

"ABC Mobile"

​
country
string
required

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

Maximum length: 2
Example:

"US"

​
email
string
required

Valid email address of brand support contact.

Maximum length: 100
​
brandRelationship
enum<string>
required

Brand relationship to the CSP Brand relationship to the CSP.

Available options:
BASIC_ACCOUNT,
SMALL_ACCOUNT,
MEDIUM_ACCOUNT,
LARGE_ACCOUNT,
KEY_ACCOUNT
​
vertical
string
required

Vertical or industry segment of the brand.

Maximum length: 50
​
cspId
string

Unique identifier assigned to the csp by the registry.

​
brandId
string

Unique identifier assigned to the brand.

Example:

"4b20017f-8da9-a992-a6c0-683072fb7729"

​
tcrBrandId
string

Unique identifier assigned to the brand by the registry.

Example:

"BBRAND1"

​
companyName
string

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

Maximum length: 100
Example:

"ABC Inc."

​
firstName
string

First name of business contact.

Maximum length: 100
Example:

"John"

​
lastName
string

Last name of business contact.

Maximum length: 100
Example:

"Smith"

​
ein
string

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

Maximum length: 20
Example:

"111111111"

​
phone
string

Valid phone number in e.164 international format.

Maximum length: 20
Example:

"+12024567890"

​
street
string

Street number and name.

Maximum length: 100
Example:

"123"

​
city
string

City name

Maximum length: 100
Example:

"New York"

​
state
string

State. Must be 2 letters code for United States.

Maximum length: 20
Example:

"NY"

​
postalCode
string

Postal codes. Use 5 digit zipcode for United States

Maximum length: 10
Example:

"10001"

​
stockSymbol
string

(Required for public company) stock symbol.

Maximum length: 10
Example:

"ABC"

​
stockExchange
enum<string>

(Required for public company) stock exchange.

Available options:
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
Example:

"NASDAQ"

​
ipAddress
string

IP address of the browser requesting to create brand identity.

Maximum length: 50
​
website
string

Brand website URL.

Maximum length: 100
Example:

"http://www.abcmobile.com"

​
altBusinessId
string

Alternate business identifier such as DUNS, LEI, or GIIN

Maximum length: 50
​
altBusinessIdType
enum<string>

An enumeration.

Available options:
NONE,
DUNS,
GIIN,
LEI
​
universalEin
string

Universal EIN of Brand, Read Only.

​
referenceId
string

Unique identifier Telnyx assigned to the brand - the brandId

​
identityStatus
enum<string>

The verification status of an active brand

Available options:
VERIFIED,
UNVERIFIED,
SELF_DECLARED,
VETTED_VERIFIED
​
optionalAttributes
object
​
mock
boolean
default:false

Mock brand for testing purposes

​
mobilePhone
string

Valid mobile phone number in e.164 international format.

Maximum length: 20
Example:

"+12024567890"

​
isReseller
boolean
default:false

Indicates whether this brand is known to be a reseller

​
webhookURL
string

Webhook to which brand status updates are sent.

Example:

"https://webhook.com/67ea78a8-9f32-4d04-b62d-f9502e8e5f93"

​
businessContactEmail
string

Business contact email.

Required if entityType is PUBLIC_PROFIT.

Example:

"name@example.com"

​
webhookFailoverURL
string

Failover webhook to which brand status updates are sent.

​
createdAt
string

Date and time that the brand was created at.

Example:

"2021-03-08T17:57:48.801186"

​
updatedAt
string

Date and time that the brand was last updated at.

Example:

"2021-03-08T17:57:48.801186"

​
status
enum<string>

Status of the brand

Available options:
OK,
REGISTRATION_PENDING,
REGISTRATION_FAILED
​
failureReasons
string

Failure reasons for brand