Create a brand

post

https://app.ekas.io/v1/brands

Creates the shared business identity that feeds 10DLC brand registration, RCS brand verification, and TFN business profiles. ein is accepted on write but never read back — reads return ein_last4 + ein_country. The brand starts at identity_status: self_declared; verification happens when it is registered.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Create a stored brand.

legal_name

string

required

display_name

string

ein

string

Tax id, e.g. 84-1234567. Write-only: reads return ein_last4. Editing later triggers paid TCR re-verification.

ein_country

string

Defaults to US

entity_type

string

enum

required

Allowed:

vertical

string

enum

TCR brand vertical.

alt_business_id

string

DUNS/LEI/GIIN — important for non-US or non-EIN entities.

alt_business_id_type

string

enum

Allowed:

website

uri

address

object

string

phone

string

stock_symbol

string

stock_exchange

string

first_name

string

Required for sole_proprietor.

last_name

string

Required for sole_proprietor.

mobile_phone

string

Sole proprietor OTP target (E.164); must be unique across sole-prop brands.

rcs_profile

object

privacy_policy_url

uri

terms_url

uri

metadata

object

Free-form string map (≤50 keys, values ≤500 chars). Filterable on list endpoints.

Headers

Idempotency-Key

string

length ≤ 255

Any unique string (e.g. a UUID). Retries with the same key within 24h return the original response with Idempotent-Replayed: true. Same key + different body → 409.

Ekas-Subaccount

string

Scope this request (and the created resource) to a subaccount.

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Brand created.

400Invalid request (malformed body, missing/invalid parameter).

401Missing or invalid API key.

403API key lacks a required scope (named in error.param) or test-only endpoint called with a live key.

409Invalid state transition, in-flight registration conflict, or idempotency key reuse with a different body.

429Rate limit exceeded; see Retry-After. RateLimit-* headers appear on every response, not only 429s.