# Create a brand

{% hint style="warning" %}
A successful request to this endpoint will mean you are charged a [brand registration](https://app.gitbook.com/s/U9kiDiTGVD8kkbnKKyEn/channels/channels/supported-channels/sms/concepts/united-states-sms-registration/sms-10dlc/brand-registration) fee. If you later need to update or resubmit your brand there may be additional fees.
{% endhint %}

## Create a brand at workspace level

> 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.<br>

```json
{"openapi":"3.0.3","info":{"title":"Numbers","version":"v1"},"tags":[{"description":"TCR Brands","name":"number_brands"}],"servers":[{"url":"https://api.bird.com","description":"Production API"}],"security":[{"accessKey":[]}],"components":{"securitySchemes":{"accessKey":{"description":"Uses the Authorization header: 'AccessKey ' followed by your access key token (e.g., 'Authorization: AccessKey AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEfGhIj')","scheme":"AccessKey","type":"http"}},"schemas":{"Workspace":{"type":"object","properties":{"entityType":{"$ref":"#/components/schemas/BrandEntityType"},"firstName":{"maxLength":100,"type":"string","description":"First or given name. Applicable to entity type."},"lastName":{"maxLength":100,"type":"string","description":"Last or Surname. Applicable to entity type."},"displayName":{"minLength":1,"maxLength":255,"type":"string","description":"Display or marketing name your brand."},"companyName":{"minLength":1,"maxLength":255,"type":"string","description":"Legal company name. This should match the legal company name used to register your EIN/Tax ID."},"ein":{"minLength":1,"maxLength":21,"type":"string","description":"Government assigned corporate tax ID. EIN is 9-digits in the U.S."},"einIssuingCountry":{"minLength":1,"maxLength":2,"type":"string","description":"The 2 letter ISO country of registration submitted with your EIN / Tax ID registration."},"phone":{"minLength":1,"maxLength":20,"type":"string","description":"Valid phone number in e.164 international format."},"street":{"minLength":1,"maxLength":100,"type":"string","description":"Street number and name."},"city":{"minLength":1,"maxLength":100,"type":"string","description":"City name"},"state":{"minLength":1,"maxLength":20,"type":"string","description":"State. Must be a 2 letter state code for US states."},"postalCode":{"minLength":1,"maxLength":10,"type":"string","description":"Postal code. Must be a 5 digit zip code for the United States."},"country":{"minLength":1,"maxLength":2,"type":"string","description":"ISO 2 character country code."},"email":{"minLength":1,"maxLength":100,"type":"string","description":"Valid email address of brand support contact."},"stockSymbol":{"maxLength":10,"type":"string","description":"Stock symbol. Required for entityType PUBLIC."},"stockExchange":{"$ref":"#/components/schemas/BrandStockExchange"},"website":{"minLength":1,"maxLength":100,"type":"string","description":"Brand website URL."},"vertical":{"maxLength":50,"type":"string","description":"Vertical or industry segment of the brand."},"altBusinessId":{"maxLength":50,"type":"string","description":"Alternate business identifier."},"altBusinessIdType":{"$ref":"#/components/schemas/BrandAltBusinessIdType"},"businessContactEmail":{"description":"Business contact email.","oneOf":[{"type":"string","format":"email"},{"type":"string","minLength":0,"maxLength":0}]}},"required":["country","displayName","email","entityType","phone","street","city","state","postalCode","companyName","ein","einIssuingCountry","website"]},"BrandEntityType":{"type":"string","description":"Legal entity type. It can't be updated when the brand is approved.","enum":["PRIVATE_PROFIT","PUBLIC_PROFIT","NON_PROFIT","GOVERNMENT",""]},"BrandStockExchange":{"type":"string","description":"Stock exchange. Required for entityType PUBLIC.","enum":["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",""]},"BrandAltBusinessIdType":{"type":"string","description":"Alternate business identifier type. Required if altBusinessId is provided.","enum":["NONE","DUNS","GIIN","LEI",""]},"WorkspaceTCRBrand":{"type":"object","additionalProperties":false,"required":["country","displayName","email","entityType","phone","street","city","state","postalCode","companyName","ein","einIssuingCountry","website"],"properties":{"id":{"type":"string","description":"The ID of the number.","format":"uuid"},"tcrBrandId":{"type":"string","description":"The Campaign Registry brand ID."},"organizationId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","description":"Timestamp (UTC) when the brand was created.","format":"date-time"},"updatedAt":{"type":"string","description":"Timestamp (UTC) when the brand was last updated.","nullable":true,"format":"date-time"},"status":{"$ref":"#/components/schemas/BrandStatus"},"authPlusStatus":{"$ref":"#/components/schemas/BrandAuthPlusStatus"},"entityType":{"$ref":"#/components/schemas/BrandEntityType"},"firstName":{"maxLength":100,"type":"string","description":"First or given name. Applicable to entity type."},"lastName":{"maxLength":100,"type":"string","description":"Last or Surname. Applicable to entity type."},"displayName":{"maxLength":255,"type":"string","description":"Display or marketing name your brand."},"companyName":{"maxLength":255,"type":"string","description":"Legal company name. This should match the legal company name used to register your EIN/Tax ID."},"ein":{"maxLength":21,"type":"string","description":"Government assigned corporate tax ID. EIN is 9-digits in the U.S."},"einIssuingCountry":{"maxLength":2,"type":"string","description":"The 2 letter ISO country of registration submitted with your EIN / Tax ID registration."},"phone":{"maxLength":20,"type":"string","description":"Valid phone number in e.164 international format."},"street":{"maxLength":100,"type":"string","description":"Street number and name."},"city":{"maxLength":100,"type":"string","description":"City name"},"state":{"maxLength":20,"type":"string","description":"State. Must be a 2 letter state code for US states."},"postalCode":{"maxLength":10,"type":"string","description":"Postal code. Must be a 5 digit zip code for the United States."},"country":{"maxLength":2,"type":"string","description":"ISO 2 character country code."},"email":{"maxLength":100,"type":"string","description":"Valid email address of brand support contact."},"stockSymbol":{"maxLength":10,"type":"string","description":"Stock symbol."},"stockExchange":{"$ref":"#/components/schemas/BrandStockExchange"},"website":{"maxLength":100,"type":"string","description":"Brand website URL."},"vertical":{"maxLength":50,"type":"string","description":"Vertical or industry segment of the brand."},"altBusinessId":{"maxLength":50,"type":"string","description":"Alternate business identifier."},"altBusinessIdType":{"$ref":"#/components/schemas/BrandAltBusinessIdType"},"businessContactEmail":{"description":"Business contact email.","oneOf":[{"type":"string","format":"email"},{"type":"string","minLength":0,"maxLength":0}]},"businessContactEmailVerifiedDate":{"type":"string","description":"Timestamp (UTC) when the brand businessContactEmail was verified.","format":"date-time"},"rejection":{"type":"object","description":"Rejection details","required":["description"],"properties":{"description":{"type":"string","description":"Rejection description"},"code":{"type":"string","description":"Rejection code"}}}}},"BrandStatus":{"type":"string","description":"Brand status","enum":["FAILED","PENDING","REJECTED","APPROVED","DELETED","DRAFT"]},"BrandAuthPlusStatus":{"type":"string","description":"Brand Auth+ status","enum":["NOT_APPLICABLE","NEEDS_CHARGE","NEEDS_TRIGGER","DONE"]},"ValidationError":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"A unique code that identifies the error. This code can be used to programmatically identify the error.\n","minLength":5},"message":{"type":"string","minLength":5,"description":"A human-readable message that describes the error. An example is 'The request body is missing the required field `service`.'\n"},"details":{"type":"object","additionalProperties":true,"description":"Additional details about the error. This object can contain any additional information that may be useful for debugging.\n"}}}}},"paths":{"/workspaces/{workspaceId}/tcr-brands":{"post":{"description":"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.\n","operationId":"createWorkspaceBrand","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceTCRBrand"}}},"description":"Brand successfully created"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}},"description":"Invalid brand"}},"summary":"Create a brand at workspace level","tags":["number_brands"]}}}}
```

## BrandRequest Object

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

## BrandResponse Object

| Field             | Type                                                                                                 | Description                                                                                   |
| ----------------- | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| entityType        | [entityType](https://docs.bird.com/api/numbers-api/api-reference/tcr-enums#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](https://docs.bird.com/api/numbers-api/api-reference/tcr-enums#stocksymbol)             | Stock symbol                                                                                  |
| stockExchange     | [stockExchange](https://docs.bird.com/api/numbers-api/api-reference/tcr-enums#stockexchange)         | Stock exchange                                                                                |
| website           | string                                                                                               | Brand website URL                                                                             |
| vertical          | [vertical](https://docs.bird.com/api/numbers-api/api-reference/tcr-enums#verticals)                  | Vertical or industry segment of the brand                                                     |
| altBusinessId     | string                                                                                               | Alternate business identifier                                                                 |
| altBusinessIdType | [altBusinessIdType](https://docs.bird.com/api/numbers-api/api-reference/tcr-enums#altbusinessidtype) | Alternate business identifier type                                                            |
| brandId           | string                                                                                               | UUID of a brand                                                                               |
| status            | [status](https://docs.bird.com/api/numbers-api/api-reference/tcr-enums#brandstatus)                  | Brand status                                                                                  |