Sign in

v77

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012528701.8 MB
Campaign Registry: Brands

Create brand

Creates a new brand for 10DLC registration.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Messaging and Numbers.

Learn more about API scopes.

post/api/relay/rest/registry/beta/brands

Request body

OR

Example request

{
  "name": "My Brand",
  "company_name": "BrandCo",
  "contact_email": "brand_info@example.com",
  "contact_phone": "+18995551212",
  "ein_issuing_country": "United States",
  "ein": "12-3456789",
  "company_address": "123 Brand St, Hill Valley CA, 91905",
  "company_website": "www.example.com",
  "status_callback_url": "https://example.com/handle_callback"
}

Response

The request has succeeded and a new resource has been created as a result.

idstring uuid required

Universal Unique Identifier.

statestring

The current state of the brand.

namestring

Brand/Marketing/DBA name of the business if applicable.

company_namestring

The legal name of the business.

contact_emailstring

A company contact email for this brand.

contact_phonestring

A contact phone number for this brand.

ein_issuing_countrystring

Country of registration.

legal_entity_typestring

What type of legal entity is the organization? (PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT)

einstring

Company EIN Number/Tax ID.

company_addressstring

Full company address.

company_verticalstring

An optional Vertical for the brand (REAL_ESTATE, HEALTHCARE, ENERGY, ENTERTAINMENT, RETAIL, AGRICULTURE, INSURANCE, EDUCATION, HOSPITALITY, FINANCIAL, GAMBLING, CONSTRUCTION, NGO, MANUFACTURING, GOVERNMENT, TECHNOLOGY, COMMUNICATION).

company_websitestring

Link to the company website.

csp_brand_referencestring

If you are your own Campaign Service Provider, this is the approved Brand ID (Mandatory for CSPs, otherwise please omit).

csp_self_registeredboolean

This value must be true for all self-registered brands.

status_callback_urlstring

Optional: Specify a URL to receive webhook notifications when your brand's state changes. See the 10DLC status callback docs for the webhook payload.

created_atstring date-time

Timestamp when the brand was created.

updated_atstring date-time

Timestamp when the brand was last updated.

Example response

{
  "state": "pending",
  "name": "My Brand",
  "company_name": "BrandCo",
  "contact_email": "brand_info@example.com",
  "contact_phone": "+18995551212",
  "ein_issuing_country": "United States",
  "legal_entity_type": "Private Company",
  "ein": "12-3456789",
  "company_address": "123 Brand St, Hill Valley CA, 91905",
  "company_vertical": "Healthcare",
  "company_website": "www.example.com",
  "status_callback_url": "https://example.com/handle_callback"
}