---
title: "Create Brand Kit"
method: POST
path: "/v3/brand-kits"
tags: ["Brand"]
---

# Create Brand Kit

`POST /v3/brand-kits`

## Request

- Base URL: `https://api.heygen.com`
- URL: `https://api.heygen.com/v3/brand-kits`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Creates a brand kit by importing logos, colors and fonts from a public website; by calling it you confirm you have the rights to use those assets. The kit assembles in the background: poll GET /v3/brand-kits/{brand_kit_id} until status is `completed`. Send an Idempotency-Key to make retries safe.

## Headers

- `Idempotency-Key` string

## Request body

- CreateBrandKitRequest: Request body for POST /v3/brand-kits.
  - `url` string, required: Public website URL to build the brand kit from. HeyGen visits the site and imports the brand assets it finds there, including logos, colors and font files. By calling this endpoint you confirm you have the rights and licenses necessary to upload, store and use those assets in HeyGen.
  - `name` string, nullable: Name for the brand kit, up to 256 characters. Defaults to the brand name detected on the site, or its domain.

## Response `201`

Created.

- object
  - `data` CreateBrandKitResponse: Response for POST /v3/brand-kits.
    - `brand_kit_id` string, required: Unique identifier of the newly created brand kit.
    - `status` 'loading', required: Assembly status, always 'loading' on creation: the kit exists and its id is usable immediately, but its assets are gathered in the background. Poll GET /v3/brand-kits/{brand_kit_id} until status is 'completed'.

## Other responses

- `400`: Invalid request parameters
- `401`: Authentication failed
- `403`: Forbidden
- `409`: A prior request with this Idempotency-Key is still in progress. Wait for the original request to complete, then retry.
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `7dfa5e59b4f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/heygen/apis/heygen-external-api/changes/v3/brand-kits/post.md)

---

[API](https://skmtc.dev/heygen/apis/heygen-external-api.md) - [All operations](https://skmtc.dev/heygen/apis/heygen-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/heygen/apis/heygen-external-api/revisions/7dfa5e59b4f5?raw)