Register a 10DLC Brand

Authorizations

Authorization

string

header

required

Bearer token using appid (Authorization: Bearer )

Body

application/json

Brand registration request.

TenDlcBrandCreateRequest
TenDlcBrandCreateRequest

10DLC Brand registration request

entity_type

enum<string>

required

The company entity type

Available options:

PRIVATE_PROFIT,

PUBLIC_PROFIT,

NON_PROFIT,

GOVERNMENT

Allowed value: "PUBLIC_PROFIT"

Example:

"PUBLIC_PROFIT"

dba_name

string

required

Brand name or DBA

Maximum string length: 255

Example:

"Brand"

company_name

string

required

Legal name of the company

Maximum string length: 255

Example:

"Company"

vertical

enum<string>

required

The segment the business operates in

Available options:

HEALTHCARE,

PROFESSIONAL,

RETAIL,

TECHNOLOGY,

EDUCATION,

FINANCIAL,

NON_PROFIT,

GOVERNMENT,

OTHER

Example:

"PROFESSIONAL"

ein_taxid

string

required

IRS Employee Identification Number (EIN) for US-based or foreign companies with EIN. The numeric portion of Tax ID for companies incorporated in other countries.

Maximum string length: 21

Example:

"12-2142342"

ein_taxid_country

string

required

2-letter ISO country code of the Tax ID issuing country

Required string length: 2

Example:

"US"

stock_symbol

string | null

required

The stock symbol of the Brand. For PUBLIC_PROFIT Brands only.

Maximum string length: 10

stock_exchange

string | null

required

The stock exchange code. For PUBLIC_PROFIT Brands only.

Maximum string length: 10

Example:

"NASDAQ"

first_name

string

required

The first name of the business contact

Maximum string length: 100

Example:

"John"

last_name

string

required

The last name of the business contact

Maximum string length: 100

Example:

"Dow"

phone_number

string

required

The support contact telephone in E.164 format

Maximum string length: 20

Example:

"12046661776"

string<email>

required

The email address of the support contact

Maximum string length: 100

Example:

"support@brand.com"

street_address

string

required

Street name and house number

Maximum string length: 100

Example:

"10, City Name"

city

string

required

The city name

Maximum string length: 100

Example:

"Miami"

state_or_province

string | null

required

State or province. For the United States, use 2 character codes.

Maximum string length: 20

Example:

"AL"

zip

string

required

The business zip or postal code

Maximum string length: 10

Example:

"12345"

country

string

required

2-letter ISO country code the business address

Required string length: 2

Example:

"US"

website

string

The website of the business

Maximum string length: 255

Example:

"Tess.com"

mock

boolean

default:false

Indicates a mock Brand. You can create mock Brands for testing purposes only, production traffic with the mock Brands is prohibited.

Example:

false

Response

10DLC Brand created.

10DLC brand details.

brand_id

string

required

Brand ID.

Example:

"BM20QP9"

dba_name

string

required

Brand name or DBA.

Example:

"Brand"

company_name

string

required

Company legal name.

Example:

"Company"

entity_type

enum<string>

required

Company entity type.

Available options:

PRIVATE_PROFIT,

PUBLIC_PROFIT,

NON_PROFIT,

GOVERNMENT

Example:

"PRIVATE_PROFIT"

vertical

string

required

Business vertical.

Example:

"HEALTHCARE"

ein_taxid

string

required

IRS EIN or Tax ID.

Example:

"999999999"

ein_taxid_country

string

required

ISO 3166-1 alpha-2 country code where the Tax ID was issued.

Example:

"US"

status

enum<string>

required

Brand identity verification status.

Available options:

REVIEW,

VERIFIED,

UNVERIFIED,

VETTED_VERIFIED,

SUSPENDED

Example:

"VERIFIED"

first_name

string

required

Business contact first name.

Example:

"John"

last_name

string

required

Business contact last name.

Example:

"Dow"

phone_number

string

required

Support contact phone number in E.164 format.

Example:

"12123450099"

string

required

Support contact email address.

Example:

"support@brand.com"

street_address

string

required

Street address.

Example:

"10, City Name"

city

string

required

City name.

Example:

"Miami"

country

string

required

ISO 3166-1 alpha-2 country code of the business address.

Example:

"US"

zip

string

required

Zip or postal code.

Example:

"12345"

feedback

string | null

required

Brand identity verification feedback.

created_at

string

required

Date and time the Brand was created in ISO 8601 format.

Example:

"2024-07-24T08:29:09"

updated_at

string

required

Date and time the Brand was updated in ISO 8601 format.

Example:

"2024-07-24T08:29:09"

website

string | null

Business website URL.

Example:

"https://brand.com"

stock_symbol

string | null

Stock symbol. Required for public companies.

stock_exchange

string | null

Stock exchange code. Required for public companies.

state_or_province

string | null

State or province.

Example:

"FL"

mock

boolean

default:false

Indicates whether the Brand is a mock brand for testing.

Example:

false

Using the APIs

API reference

WebSocket protocol

Register a 10DLC Brand

Authorizations

Body

Response