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.
POST
/workspaces/{workspaceId}/tcr-brands
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.
Corps de la requête
entityType
string
obligatoire
Legal entity type. It can't be updated when the brand is approved.
Possible values: PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, GOVERNMENT, ``
firstName
string
First or given name. Applicable to entity type.
lastName
string
Last or Surname. Applicable to entity type.
displayName
string
obligatoire
Display or marketing name your brand.
companyName
string
obligatoire
Legal company name. This should match the legal company name used to register your EIN/Tax ID.
ein
string
obligatoire
Government assigned corporate tax ID. EIN is 9-digits in the U.S.
einIssuingCountry
string
obligatoire
The 2 letter ISO country of registration submitted with your EIN / Tax ID registration.
phone
string
obligatoire
Valid phone number in e.164 international format.
street
string
obligatoire
Street number and name.
city
string
obligatoire
City name
state
string
obligatoire
State. Must be a 2 letter state code for US states.
postalCode
string
obligatoire
Postal code. Must be a 5 digit zip code for the United States.
country
string
obligatoire
ISO 2 character country code.
email
string
obligatoire
Valid email address of brand support contact.
stockSymbol
string
Stock symbol. Required for entityType PUBLIC.
stockExchange
string
Stock exchange. Required for entityType PUBLIC.
Possible values: NONE, NASDAQ, NYSE, AMEX, AMX, ASX, B3, BME, BSE, FRA, ICEX, JPX, JSE, KRX, LON, NSE, OMX, SEHK, SGX, SSE, STO, SWX, SZSE, TSX, TWSE, VSE, OTHER, ``
website
string
obligatoire
Brand website URL.
vertical
string
Vertical or industry segment of the brand.
altBusinessId
string
Alternate business identifier.
altBusinessIdType
string
Alternate business identifier type. Required if altBusinessId is provided.
Possible values: NONE, DUNS, GIIN, LEI, ``
businessContactEmail
string
Business contact email.
Corps de la réponse
id
string
The ID of the number.
tcrBrandId
string
The Campaign Registry brand ID.
organizationId
string
createdAt
string
Timestamp (UTC) when the brand was created.
updatedAt
string
Timestamp (UTC) when the brand was last updated.
status
string
Brand status
Possible values: FAILED, PENDING, REJECTED, APPROVED, DELETED, DRAFT
authPlusStatus
string
Brand Auth+ status
Possible values: NOT_APPLICABLE, NEEDS_CHARGE, NEEDS_TRIGGER, DONE
entityType
string
obligatoire
Legal entity type. It can't be updated when the brand is approved.
Possible values: PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, GOVERNMENT, ``
firstName
string
First or given name. Applicable to entity type.
lastName
string
Last or Surname. Applicable to entity type.
displayName
string
obligatoire
Display or marketing name your brand.
companyName
string
obligatoire
Legal company name. This should match the legal company name used to register your EIN/Tax ID.
ein
string
obligatoire
Government assigned corporate tax ID. EIN is 9-digits in the U.S.
einIssuingCountry
string
obligatoire
The 2 letter ISO country of registration submitted with your EIN / Tax ID registration.
phone
string
obligatoire
Valid phone number in e.164 international format.
street
string
obligatoire
Street number and name.
city
string
obligatoire
City name
state
string
obligatoire
State. Must be a 2 letter state code for US states.
postalCode
string
obligatoire
Postal code. Must be a 5 digit zip code for the United States.
country
string
obligatoire
ISO 2 character country code.
email
string
obligatoire
Valid email address of brand support contact.
stockSymbol
string
Stock symbol.
stockExchange
string
Stock exchange. Required for entityType PUBLIC.
Possible values: NONE, NASDAQ, NYSE, AMEX, AMX, ASX, B3, BME, BSE, FRA, ICEX, JPX, JSE, KRX, LON, NSE, OMX, SEHK, SGX, SSE, STO, SWX, SZSE, TSX, TWSE, VSE, OTHER, ``
website
string
obligatoire
Brand website URL.
vertical
string
Vertical or industry segment of the brand.
altBusinessId
string
Alternate business identifier.
altBusinessIdType
string
Alternate business identifier type. Required if altBusinessId is provided.
Possible values: NONE, DUNS, GIIN, LEI, ``
businessContactEmail
string
Business contact email.
businessContactEmailVerifiedDate
string
Timestamp (UTC) when the brand businessContactEmail was verified.
rejection
object
Rejection details
Afficher les attributs enfants
rejection.description
string
obligatoire
Rejection description
rejection.code
string
Rejection code
Exemple de code
curl -X POST 'https://api.bird.com/workspaces/{workspaceId}/tcr-brands' \
-H 'Authorization: AccessKey YOUR_ACCESS_KEY'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 |
| 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 |
| 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 |