---
title: "Create Brand"
method: POST
path: "/brands"
---

# Create Brand

`POST /brands`

Create a new brand

## Request body

- APICreateBrandInput
  - `name` string, required
  - `alternative_names` string[]
  - `excluded_names` string[] — Phrases that must never count as a mention of this brand, e.g. a brand 'Caliber' excluding 'Caliber Auto Wash'.
  - `website` string, required
  - `alternative_websites` string[]
  - `description` string, required
  - `competitors` APICompetitorInput[]
    - `name` string, required
    - `alternative_names` string[]
    - `excluded_names` string[] — Phrases that must never count as a mention of this competitor, e.g. a competitor 'Caliber' excluding 'Caliber Auto Wash'.
    - `websites` string[]
    - `case_sensitive` boolean — When true, name and alternative_names are matched against AI responses with exact case. Defaults to case-insensitive matching.
  - `personas` APIPersonaInput[]
    - `name` string, required
    - `description` string, required
  - `key_topics` string[]
  - `status` 'lead' | 'prospect' | 'customer'
  - `case_sensitive` boolean — When true, the brand name and alternative_names are matched against AI responses with exact case. Defaults to case-insensitive matching.

## Response `200`

Successful Response

- APICreateBrandResponse
  - `id` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-12** `1d487d04437f` — 2 info
  - added the new optional request property `competitors/items/excluded_names`
  - added the new optional request property `excluded_names`

[Change history](https://skmtc.dev/scrunchai/apis/scrunch-data-api/changes/brands/post.md)

---

[API](https://skmtc.dev/scrunchai/apis/scrunch-data-api.md) · [All operations](https://skmtc.dev/scrunchai/apis/scrunch-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scrunchai/scrunch-data-api/revisions/7df8cb682a8d/schema)