---
search:
  tags:
    - Brands
    - POST
seo:
  description: >-
    Creates a brand and starts reading its website to fill in its details.
    Returns 201 with… Reference for the POST /brands endpoint in the Zaraftis
    Public API.
sidebar:
  label: Create a brand
  badge: POST
title: Create a brand
type: openapi-operation
---
Creates a brand and starts reading its website to fill in its details. Returns 201 with the brand. A credential limited to a brand allowlist cannot create brands. A brand with the same URL or name already in the workspace answers 409 with details.existing_brand ({ brand_id, name }) for that existing brand.

`POST /brands`

**Request body** (`application/json`, required)

- `name` (string, required)
- `url` (string<uri>, required)
- `country` (string)
- `language` (string)

Request body example:

```json
{
  "name": "string",
  "url": "http://example.com",
  "country": "US",
  "language": "en"
}
```

**Responses**

- `201` — Created brand (public Brand shape in the success envelope)
- `400` — bad\_request or validation\_failed
- `409` — conflict, duplicate\_url, or idempotency\_conflict

Response example, 201:

```json
{
  "success": true,
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "organizationId": "string",
    "name": "string",
    "url": "string",
    "status": "pending",
    "crawlStartedAt": "2019-08-24T14:15:22Z",
    "competitorsDetectedAt": "2019-08-24T14:15:22Z",
    "description": "string",
    "siteUrls": [
      "string"
    ],
    "siteContent": {
      "whatItIs": {
        "text": "string",
        "sources": [
          "string"
        ]
      },
      "whoItsFor": {
        "text": "string",
        "sources": [
          "string"
        ]
      },
      "vertical": "ecommerce_dtc",
      "offerings": {
        "text": "string",
        "sources": [
          "string"
        ]
      },
      "buyingSituations": {
        "text": "string",
        "sources": [
          "string"
        ]
      },
      "howBuyersPay": {
        "text": "string",
        "sources": [
          "string"
        ]
      },
      "whyChooseIt": {
        "text": "string",
        "sources": [
          "string"
        ]
      },
      "proof": [
        {
          "claim": "string",
          "quote": "string",
          "url": "string"
        }
      ],
      "contentCoverage": {
        "text": "string",
        "sources": [
          "string"
        ]
      }
    },
    "crawlError": "string",
    "country": "st",
    "language": "string",
    "vertical": "ecommerce_dtc",
    "roleType": "string",
    "companySize": "string",
    "onboardingStep": "brand_created",
    "onboardingFlow": "first_signup",
    "packExpandedAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  },
  "request_id": "string"
}
```