---
search:
  tags:
    - Brands
    - POST
seo:
  description: >-
    Creates a Brand in your organization. The body is optional, because you
    write a Brand… Reference for the POST /context/brands endpoint in the
    AdCrunch API.
sidebar:
  label: Create a Brand
  badge: POST
title: Create a Brand
type: openapi-operation
---
Creates a Brand in your organization. The body is optional, because you write a Brand one part at a time. AdCrunch makes the slug from the name. To set a different slug, send one. The answer is `409` if the slug already exists in your organization.

`POST /context/brands`

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

- `body` (string) — What an agent reads to act for this Brand (markdown), at most 50,000 characters. Suggested headings: Identity, Voice, Guidelines, Messaging. The headings are advice, not schema.
- `description` (string, required) — One-line summary — what agents read to pick this Brand.
- `name` (string, required) — Display name.
- `slug` (string) — Optional explicit slug handle; normalized to kebab-case. Defaults to one derived from the name.
- `website_url` (string<uri>) — The Brand's public site — a locator like the slug, not part of the body. Setting it does nothing on its own; reading it is a separate, explicit call.

Request body example:

```json
{
  "body": "## Identity\n\nAcme makes one running shoe and sells it direct. The promise is a thousand kilometres on the same pair, and a resole rather than a replacement.\n\n## Voice\n\nPlain and measured. Short sentences. No superlative the shoe cannot earn.\n\n## Guidelines\n\n- Name the distance, never the \"journey\".\n- Claim the kilometres the shoe is tested to, and no more.\n- Do not compare the shoe to a named competitor.\n\n## Messaging\n\n- One shoe, a thousand kilometres.\n- Resole it twice, and keep running on it.\n- Sold direct, so the price is the cost of the shoe.",
  "description": "Running shoes sold direct to the runner, made to last a thousand kilometres.",
  "name": "Acme",
  "slug": "acme",
  "website_url": "https://acme.example"
}
```

**Responses**

- `201` — The Brand as created, at \`revision\` 1. An unwritten body comes back \`null\`, which is a normal state rather than an error.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`brand:write\`. \`error\` is \`forbidden\`.
- `409` — Another Brand in this organization already holds that slug. \`error\` is \`slug\_conflict\`. A Skill may share it — each aggregate is addressed through its own surface.
- `422` — The name and slug together contain no letter or digit. \`error\` is \`invalid\_slug\`.

Response example, 201:

```json
{
  "assignees": [
    {
      "id": "usr_4d8b12",
      "name": "Maya Lindqvist"
    }
  ],
  "body": null,
  "createdAt": 1790000000000,
  "createdBy": "usr_4d8b12",
  "description": "Running shoes sold direct to the runner, made to last a thousand kilometres.",
  "id": "brd_6a9c33",
  "logoDocumentId": null,
  "name": "Acme",
  "revision": 1,
  "slug": "acme",
  "updatedAt": null,
  "websiteUrl": "https://acme.example"
}
```
