Register a brand

POST

10dlc

brands

{id}

cURL

curl --request POST \
  --url https://api.vobiz.ai/api/v1/sms/10dlc/brands/{id}/register \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'

const options = {
  method: 'POST',
  headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};

fetch('https://api.vobiz.ai/api/v1/sms/10dlc/brands/{id}/register', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "5f1c3a2e-7b4d-4e8f-9a0b-1c2d3e4f5a60",
  "accountId": "MA_XXXXXXXX",
  "name": "Example Corp",
  "legalName": "Example Corporation Inc.",
  "brandType": "TENDLC_PRIVATE_COMPANY",
  "stage": "SUBMITTED",
  "registrationStatus": "PENDING",
  "brandIdentityStatus": "UNVERIFIED",
  "website": "https://example.com",
  "supportEmail": "support@example.com",
  "supportPhone": "+14155550100",
  "vertical": "TECHNOLOGY",
  "taxId": "12-3456789",
  "taxIdIssuingCountry": "US",
  "countryCode": "US",
  "businessContactFirstName": "Alex",
  "businessContactLastName": "Doe",
  "legalEntityType": "PRIVATE_COMPANY",
  "lastSyncedAt": "2026-10-12T11:05:00Z",
  "createdAt": "2026-10-12T10:30:00Z",
  "updatedAt": "2026-10-12T11:05:00Z"
}

{
  "error": "missing or invalid credentials"
}

{
  "error": "brand not found"
}

{
  "error": "registration provider rejected the request: taxId is required for TENDLC_PRIVATE_COMPANY",
  "providerError": "registration error 400 (HTTP 400): taxId is required"
}

{
  "error": "internal error"
}

{
  "error": "registration provider unavailable",
  "providerError": "registration error 500 (HTTP 500): upstream timeout"
}

{
  "error": "registration provider rejected the service credentials",
  "providerError": "registration error 401 (HTTP 401): unauthorized"
}

Authorizations

X-Auth-ID

string

header

required

Your Vobiz account Auth ID (MA_XXXXXXXX).

X-Auth-Token

string

header

required

Your Vobiz account Auth Token.

Path Parameters

string<uuid>

required

Brand ID (UUID) returned by POST /10dlc/brands. An unknown ID, an ID from another account, or a value that is not a UUID returns 404 with {"error":"brand not found"}.

Response

The brand after submission.

A brand on your account: the business behind your 10DLC traffic and its state at the US 10DLC registry. Optional fields are omitted when empty, and registry state is refreshed when you retrieve the brand.

string<uuid>

Brand ID (UUID) on your account. Use it in every /10dlc/brands/{id} path and as brandId when you create a campaign.

Example:

"5f1c3a2e-7b4d-4e8f-9a0b-1c2d3e4f5a60"

accountId

string

Your Vobiz account ID (MA_...). Always the account whose credentials made the request.

Example:

"MA_XXXXXXXX"

name

string

Display name you gave the brand when you created it.

Example:

"Example Corp"

legalName

string

Registered legal name of the business. Omitted when not set.

Example:

"Example Corporation Inc."

brandType

enum<string>

Kind of business behind the brand: TENDLC_PRIVATE_COMPANY (privately held business), TENDLC_PUBLIC_COMPANY (publicly traded company; also goes through brand authentication), TENDLC_NON_PROFIT (registered non-profit), TENDLC_GOVERNMENT (government body) or TOLL_FREE_NUMBER (a business registered for toll-free messaging).

Available options:

TENDLC_PRIVATE_COMPANY,

TENDLC_PUBLIC_COMPANY,

TENDLC_NON_PROFIT,

TENDLC_GOVERNMENT,

TOLL_FREE_NUMBER

stage

enum<string>

Where the brand is in your workflow: DRAFT until you call POST /10dlc/brands/{id}/register, then SUBMITTED.

Available options:

DRAFT,

SUBMITTED

registrationStatus

enum<string>

The registrar's decision, present once the brand is submitted. PENDING while under review, PENDING_2FA while a public company's business contact completes brand authentication, PENDING_APPEAL while an appeal is reviewed, ACTIVE when approved and REJECTED when declined (see rejectionReasons).

Available options:

ACTIVE,

PENDING,

PENDING_2FA,

PENDING_APPEAL,

REJECTED

brandIdentityStatus

string

Identity verification result from the registry, for example VERIFIED, UNVERIFIED or VETTED_VERIFIED. Omitted until the registry reports one.

Example:

"VERIFIED"

rejectionReasons

object[]

Rejections recorded by registrars, one entry per registrar. Omitted when there are none; fix the brand with PUT /10dlc/brands/{id} and register it again.

Show child attributes

website

string<uri>

Business website as submitted to the registry. Omitted when not set.

Example:

"https://example.com"

supportEmail

string

Support email address for the business. Omitted when not set.

Example:

"support@example.com"

supportPhone

string

Support phone number for the business, in E.164 format. Omitted when not set.

Example:

"+14155550100"

vertical

string

Industry vertical code as submitted to the registry, for example TECHNOLOGY. Omitted when not set.

Example:

"TECHNOLOGY"

taxId

string

Tax identifier of the business, for example a US EIN. Omitted when not set.

Example:

"12-3456789"

taxIdIssuingCountry

string

ISO 3166-1 alpha-2 code of the country that issued taxId, for example US. Omitted when not set.

Example:

"US"

countryCode

string

ISO 3166-1 alpha-2 code of the country where the business is registered. Omitted when not set.

Example:

"US"

address

object

Postal address of the business as submitted to the registry. Omitted when not set.

Show child attributes

alternateBusinessId

object

Alternate business identifier (for example a DUNS or LEI record), returned as you sent it. Omitted when not set.

businessContactFirstName

string

First name of the business contact the registry can reach. Omitted when not set.

Example:

"Alex"

businessContactLastName

string

Last name of the business contact the registry can reach. Omitted when not set.

Example:

"Doe"

businessContactEmail

string

Email address of the business contact; brand-authentication and 2FA requests go here. Omitted when not set.

Example:

"alex.doe@example.com"

businessDba

string

Trading name ("doing business as") when it differs from legalName. Omitted when not set.

legalEntityType

string

Legal entity type as submitted to the registry, for example PRIVATE_COMPANY. Omitted when not set.

Example:

"PRIVATE_COMPANY"

businessRegistrationType

string

Type of business registration number for a business outside the US, for example VAT. Omitted when not set.

stockExchange

string

Exchange where a TENDLC_PUBLIC_COMPANY brand is listed. Omitted when not set.

stockSymbol

string

Ticker symbol of a TENDLC_PUBLIC_COMPANY brand. Omitted when not set.

taxExemptStatus

string

Tax-exempt status of a TENDLC_NON_PROFIT brand. Omitted when not set.

lastSyncedAt

string<date-time>

When Vobiz last refreshed this record from the US 10DLC registry, in ISO 8601 (RFC 3339) UTC. Omitted until the first refresh.

Example:

"2026-10-12T10:35:00Z"

createdAt

string<date-time>

When the record was created on your account, in ISO 8601 (RFC 3339) UTC.

Example:

"2026-10-12T10:30:00Z"

updatedAt

string<date-time>

When the record last changed on your account, in ISO 8601 (RFC 3339) UTC.

Example:

"2026-10-12T10:35:00Z"

⌘I

cURL

curl --request POST \
  --url https://api.vobiz.ai/api/v1/sms/10dlc/brands/{id}/register \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'

const options = {
  method: 'POST',
  headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};

fetch('https://api.vobiz.ai/api/v1/sms/10dlc/brands/{id}/register', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "5f1c3a2e-7b4d-4e8f-9a0b-1c2d3e4f5a60",
  "accountId": "MA_XXXXXXXX",
  "name": "Example Corp",
  "legalName": "Example Corporation Inc.",
  "brandType": "TENDLC_PRIVATE_COMPANY",
  "stage": "SUBMITTED",
  "registrationStatus": "PENDING",
  "brandIdentityStatus": "UNVERIFIED",
  "website": "https://example.com",
  "supportEmail": "support@example.com",
  "supportPhone": "+14155550100",
  "vertical": "TECHNOLOGY",
  "taxId": "12-3456789",
  "taxIdIssuingCountry": "US",
  "countryCode": "US",
  "businessContactFirstName": "Alex",
  "businessContactLastName": "Doe",
  "legalEntityType": "PRIVATE_COMPANY",
  "lastSyncedAt": "2026-10-12T11:05:00Z",
  "createdAt": "2026-10-12T10:30:00Z",
  "updatedAt": "2026-10-12T11:05:00Z"
}

{
  "error": "missing or invalid credentials"
}

{
  "error": "brand not found"
}

{
  "error": "registration provider rejected the request: taxId is required for TENDLC_PRIVATE_COMPANY",
  "providerError": "registration error 400 (HTTP 400): taxId is required"
}

{
  "error": "internal error"
}

{
  "error": "registration provider unavailable",
  "providerError": "registration error 500 (HTTP 500): upstream timeout"
}

{
  "error": "registration provider rejected the service credentials",
  "providerError": "registration error 401 (HTTP 401): unauthorized"
}

Getting Started

API Reference

Guides

Register a brand

Authorizations

Path Parameters

Response