---
title: "API · BrandKit · Create a new (empty) brand kit (V2)"
method: POST
path: "/api/v2/brandkits"
tags: ["brandKits"]
---

# API · BrandKit · Create a new (empty) brand kit (V2)

`POST /api/v2/brandkits`

## Request

- Base URL: `https://api.simplified.com`
- URL: `https://api.simplified.com/api/v2/brandkits`
- Auth: API key in header `Authorization`

Create a new brand kit in the workspace. Only `title` is required — this
makes an empty V2 kit. Populate it afterwards with `buildBrandKit` (canonical
brand/style document) and/or context documents (`createContextDocument`).

Typical onboarding flow:
1. `createBrandKit` with the brand name as `title` → returns the kit `id` (UUID)
2. `buildBrandKit` with the canonical BrandKitDocument to fill brand + style
3. `getBrandKit?expand=extra` to read it back

## Request body

- object
  - `title` string, required: Brand name — the only field needed to create a kit.

## Response `201`

Brand kit created. Returns the new kit including its `id` (UUID) for subsequent calls.

- unknown

## Other responses

- `400`: Validation error (e.g. missing title)
- `401`: Unauthorized

---

[API](https://skmtc.dev/simplified/apis/platform.md) - [All operations](https://skmtc.dev/simplified/apis/platform/llms.txt) - [OpenAPI document](https://skmtc.dev/simplified/apis/platform/revisions/0815a1ba1e4e?raw)