REST ClientRegistryBrands

create

View as MarkdownOpen in Claude

Register a new 10DLC brand.

Request

CreateManagedBrandRequestobjectRequired
Request body for registering a new managed brand for 10DLC registration.
OR
CreateCspBrandRequestobjectRequired
Request body for importing a self-registered CSP brand. Use this when you have already registered your brand directly with TCR.

Response

idstringRequiredformat: "uuid"
The unique identifier of the brand.
statestringOptional
The current state of the brand.
namestringOptional
Brand/Marketing/DBA name of the business if applicable.
company_namestringOptional
The legal name of the business.
contact_emailstringOptional
A company contact email for this brand.
contact_phonestringOptional
A contact phone number for this brand.
ein_issuing_countrystringOptional
Country of registration.
legal_entity_typestringOptional
What type of legal entity is the organization? (PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT)
einstringOptional
Company EIN Number/Tax ID.
company_addressstringOptional
Full company address.
company_verticalstringOptional
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_websitestringOptional
Link to the company website.
csp_brand_referencestringOptional
If you are your own Campaign Service Provider, this is the approved Brand ID (Mandatory for CSPs, otherwise please omit).
csp_self_registeredbooleanOptional
This value must be true for all self-registered brands.
status_callback_urlstringOptional
Optional: Specify a URL to receive webhook notifications when your brand's state changes. See the [10DLC status callback](/docs/apis/rest/campaign-registry/webhooks/ten-dlc-status-callback) docs for the webhook payload.
created_atdatetimeOptional
Timestamp when the brand was created.
updated_atdatetimeOptional
Timestamp when the brand was last updated.

Response Example

Response
1{
2  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3  "state": "pending",
4  "name": "My Brand",
5  "company_name": "BrandCo",
6  "contact_email": "brand_info@example.com",
7  "contact_phone": "+18995551212",
8  "ein_issuing_country": "United States",
9  "legal_entity_type": "Private Company",
10  "ein": "12-3456789",
11  "company_address": "123 Brand St, Hill Valley CA, 91905",
12  "company_vertical": "Healthcare",
13  "company_website": "www.example.com",
14  "csp_brand_reference": "string",
15  "csp_self_registered": false,
16  "status_callback_url": "https://example.com/handle_callback",
17  "created_at": "2024-01-15T09:30:00Z",
18  "updated_at": "2024-01-15T09:30:00Z"
19}

Example

1from signalwire.rest import RestClient
2
3client = RestClient(
4    project="your-project-id",
5    token="your-api-token",
6    host="your-space.signalwire.com",
7)
8
9brand = client.registry.brands.create(
10    company_name="Acme Corp",
11    ein="12-3456789",
12    legal_entity_type="PRIVATE_PROFIT",
13    company_vertical="TECHNOLOGY",
14    company_website="https://acme.example.com",
15    country="US",
16)
17print("Brand ID:", brand.get("id"))