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 brand at organization level

post

Create a brand at organization-level. This means it will be available for all workspaces under this organization. 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

organizationIdstring · uuidRequired

The ID for the organization.

Example: d0b85ccc-b63a-4e81-b698-c359d77d250e

Body

application/json

Responses

201

Brand successfully created

application/json

422

Invalid brand

application/json

post

/organizations/{organizationId}/tcr-brands

HTTPcURLJavaScriptPython

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

{
  "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]",
  "workspaceIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "organizationWide": true
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "tcrBrandId": "text",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-01-29T10:42:54.402Z",
  "updatedAt": "2026-01-29T10:42:54.402Z",
  "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-29T10:42:54.402Z",
  "rejection": {
    "description": "text",
    "code": "text"
  },
  "workspaceIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "organizationWide": true
}

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
workspaceIds	array<UUID>	An array of valid workspace IDs associated with organisation. Brand will be shared with workspace Ids listed	Required

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
workspaceIds	array<UUID>	An array of valid workspace IDs associated with organisation. Brand will be shared with workspace Ids listed