POST
/
v1
/
brand
/
create
curl --request POST \
  --url https://api.sendo.dev/v1/brand/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "entityType": "<string>",
  "entityName": "<string>",
  "displayName": "<string>",
  "ein": "<string>",
  "website": "<string>",
  "privacyLink": "<string>",
  "street": "<string>",
  "city": "<string>",
  "state": "<string>",
  "postalCode": "<string>",
  "country": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "email": "<string>",
  "phone": "<string>"
}'
{
  "success": true,
  "brand": {
    "id": "h4cQ2gls",
    "createdAt": "2023-12-12T12:33:33.630Z",
    "updatedAt": "2023-12-12T12:33:33.630Z",
    "status": "VERIFIED",
    "entityType": "PRIVATE_PROFIT",
    "vetted": true,
    "trustScore": 73,
    "displayName": "Sendo AI",
    "entityName": "Winno Inc.",
    "ein": "12-3456789",
    "website": "https://sendo.dev",
    "privacyLink": "https://sendo.dev/privacy",
    "address": {
      "street": "584 Castro St #2028",
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94114",
      "country": "US"
    },
    "contact": {
      "firstName": "John",
      "lastName": "Smith",
      "phone": "+12061234567",
      "email": "support@sendo.dev"
    }
  }
}

This endpoint lets resellers create brands programatically for their customers. Right now we only support API brand creation for private companies (PRIVATE_PROFIT). Once the brand is created, you will immediately be able to create a campaign for the brand.

​
Body

​
entityType
string
required

Type of legal entity. Currently only PRIVATE_PROFIT is supported.

​
entityName
string
required

Name of the brand’s registered legal entity.

​
displayName
string

Display name or DBA name of the brand (optional)

​
ein
string
required

EIN for the legal entity (must match the name).

​
website
string
required

Link to brand’s website or other web presence.

​
privacyLink
string

Privacy Policy URL for the brand. (guide)

​
street
string
required

Street for the brand address (must match IRS records).

​
city
string
required

City for the brand address.

​
state
string
required

State for the brand address, e.g. WA, CA, NY.

​
postalCode
string
required

Five-digit postal code for the brand address.

​
country
string
required

Two-letter country code for the address, e.g. US, CA, GB.

​
firstName
string
required

First name of support contact.

​
lastName
string
required

Last name of support contact.

​
email
string
required

Email address for support contact.

​
phone
string
required

Phone number for support contact. Must be format.

​
Response

​
success
boolean

Whether the brand was created successfully.

​
brand
object

The contents of the brand.

​
error
string

Error message if the request fails.

​
Errors

If the request fails, it will return an HTTP error status code and an error field in the body with details. Full list of status codes here.

{
  "success": true,
  "brand": {
    "id": "h4cQ2gls",
    "createdAt": "2023-12-12T12:33:33.630Z",
    "updatedAt": "2023-12-12T12:33:33.630Z",
    "status": "VERIFIED",
    "entityType": "PRIVATE_PROFIT",
    "vetted": true,
    "trustScore": 73,
    "displayName": "Sendo AI",
    "entityName": "Winno Inc.",
    "ein": "12-3456789",
    "website": "https://sendo.dev",
    "privacyLink": "https://sendo.dev/privacy",
    "address": {
      "street": "584 Castro St #2028",
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94114",
      "country": "US"
    },
    "contact": {
      "firstName": "John",
      "lastName": "Smith",
      "phone": "+12061234567",
      "email": "support@sendo.dev"
    }
  }
}