Create a brand

A successful request to this endpoint will mean you are charged a brand registration fee. If you later need to update or resubmit your brand there may be additional fees.

Create a brand at workspace level

post

Create a brand at workspace level. This means it will be available only for this workspace. A brand registration is mandatory due to compliance requirements.

Authorizations

accessKey

HTTPRequired

Uses the Authorization header: 'AccessKey ' followed by your access key token (e.g., 'Authorization: AccessKey AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEfGhIj')

Path parameters

workspaceIdstring · uuidRequired

The ID for the workspace.

Example: d386a801-ee8d-4aba-a7e4-78671bd3b11e

Body

application/json

entityTypestring · enumRequired

Legal entity type. It can't be updated when the brand is approved.

Example: PRIVATE_PROFITPossible values:

firstNamestring · max: 100Optional

First or given name. Applicable to entity type.

Example: John

lastNamestring · max: 100Optional

Last or Surname. Applicable to entity type.

Example: Doe

displayNamestring · min: 1 · max: 255Required

Display or marketing name your brand.

Example: ABC Mobile

companyNamestring · min: 1 · max: 255Required

Legal company name. This should match the legal company name used to register your EIN/Tax ID.

Example: ABC Inc.

einstring · min: 1 · max: 21Required

Government assigned corporate tax ID. EIN is 9-digits in the U.S.

Example: 111111111

einIssuingCountrystring · min: 1 · max: 2Required

The 2 letter ISO country of registration submitted with your EIN / Tax ID registration.

Example: US

phonestring · min: 1 · max: 20Required

Valid phone number in e.164 international format.

Example: [phone]

streetstring · min: 1 · max: 100Required

Street number and name.

Example: 123 6th Ave

citystring · min: 1 · max: 100Required

City name

Example: New York

statestring · min: 1 · max: 20Required

State. Must be a 2 letter state code for US states.

Example: NY

postalCodestring · min: 1 · max: 10Required

Postal code. Must be a 5 digit zip code for the United States.

Example: 10001

countrystring · min: 1 · max: 2Required

ISO 2 character country code.

Example: US

emailstring · min: 1 · max: 100Required

Valid email address of brand support contact.

Example: [email protected]

stockSymbolstring · max: 10Optional

Stock symbol. Required for entityType PUBLIC.

Example: ABC

stockExchangestring · enumOptional

Stock exchange. Required for entityType PUBLIC.

Example: NASDAQPossible values:

websitestring · min: 1 · max: 100Required

Brand website URL.

Example: https://example.com

verticalstring · max: 50Optional

Vertical or industry segment of the brand.

Example: RETAIL

altBusinessIdstring · max: 50Optional

Alternate business identifier.

altBusinessIdTypestring · enumOptional

Alternate business identifier type. Required if altBusinessId is provided.

Possible values:

businessContactEmailone ofOptional

Business contact email.

string · emailOptional

or

stringOptional

Responses

201

Brand successfully created

application/json

422

Invalid brand

application/json

post

/workspaces/{workspaceId}/tcr-brands

HTTPcURLJavaScriptPython

POST /workspaces/{workspaceId}/tcr-brands HTTP/1.1
Host: api.bird.com
Authorization: AccessKey YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 488

{
  "entityType": "PRIVATE_PROFIT",
  "firstName": "John",
  "lastName": "Doe",
  "displayName": "ABC Mobile",
  "companyName": "ABC Inc.",
  "ein": "111111111",
  "einIssuingCountry": "US",
  "phone": "[phone]",
  "street": "123 6th Ave",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "[email protected]",
  "stockSymbol": "ABC",
  "stockExchange": "NASDAQ",
  "website": "https://example.com",
  "vertical": "RETAIL",
  "altBusinessId": "text",
  "altBusinessIdType": "NONE",
  "businessContactEmail": "[email protected]"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "tcrBrandId": "text",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-01-29T09:15:47.509Z",
  "updatedAt": "2026-01-29T09:15:47.509Z",
  "status": "PENDING",
  "authPlusStatus": "NOT_APPLICABLE",
  "entityType": "PRIVATE_PROFIT",
  "firstName": "John",
  "lastName": "Doe",
  "displayName": "ABC Mobile",
  "companyName": "ABC Inc.",
  "ein": "111111111",
  "einIssuingCountry": "US",
  "phone": "[phone]",
  "street": "123 6th Ave",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "[email protected]",
  "stockSymbol": "ABC",
  "stockExchange": "NASDAQ",
  "website": "https://example.com",
  "vertical": "RETAIL",
  "altBusinessId": "text",
  "altBusinessIdType": "NONE",
  "businessContactEmail": "[email protected]",
  "businessContactEmailVerifiedDate": "2026-01-29T09:15:47.509Z",
  "rejection": {
    "description": "text",
    "code": "text"
  }
}

BrandRequest Object

Field	Type	Description	Mandatory
entityType	entityType	Legal entity type	Required
displayName	string	Display or marketing name your brand	Required for entityType PRIVATE/PUBLIC
companyName	string	Legal company name. This should match the legal company name used to register your EIN/Tax ID	Required
ein	string	Government assigned corporate tax ID. EIN is 9-digits in the U.S.	Required
einIssuingCountry	string	The 2 letter ISO country of registration submitted with your EIN / Tax ID registration	Required
phone	string	Valid phone number in e.164 international format.	Required
street	string	Street number and name	Required
city	string	City name	Required
state	string	State. Must be a 2 letter state code for US states	Required
postalCode	string	Postal code. Must be a 5 digit zip code for the United States	Required
country	string	ISO 2 character country code	Required
email	string	Valid email address of brand support contact	Required
stockSymbol	stockSymbol	Stock symbol	Required for entityType PUBLIC
stockExchange	stockExchange	Stock exchange	Required for entityType PUBLIC
website	string	Brand website URL	Required
vertical	vertical	Vertical or industry segment of the brand	Required
altBusinessId	string	Alternate business identifer	Optional
altBusinessIdType	altBusinessIdType	Alternate business identifier type	Required if altBusinessId is provided

BrandResponse Object

Field	Type	Description
entityType	entityType	Legal entity type
displayName	string	Display or marketing name your brand
companyName	string	Legal company name. This should match the legal company name used to register your EIN/Tax ID
ein	string	Government assigned corporate tax ID. EIN is 9-digits in the U.S.
einIssuingCountry	string	The 2 letter ISO country of registration submitted with your EIN / Tax ID registration
phone	string	Valid phone number in e.164 international format.
street	string	Street number and name
city	string	City name
state	string	State. Must be a 2 letter state code for US states
postalCode	string	Postal code. Must be a 5 digit zip code for the United States
country	string	ISO 2 character country code
email	string	Valid email address of brand support contact
stockSymbol	stockSymbol	Stock symbol
stockExchange	stockExchange	Stock exchange
website	string	Brand website URL
vertical	vertical	Vertical or industry segment of the brand
altBusinessId	string	Alternate business identifier
altBusinessIdType	altBusinessIdType	Alternate business identifier type
brandId	string	UUID of a brand
status	status	Brand status