> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Brand Kits

> Create a brand kit over the API by importing a website's colors, fonts, and logos, then pass its brand_kit_id to Video Agent so every generated video ships on-brand.

![](https://mintcdn.com/heygen-1fa696a7/hfMXXwJzjE7vBSYZ/images/theme/research.webp?fit=max\&auto=format\&n=hfMXXwJzjE7vBSYZ\&q=85\&s=3e4c2594813dcfd56985f3d63e3ba321)

A brand kit is a saved set of brand colors, fonts, and logos. Pass its `brand_kit_id` to the [Video Agent](https://heygen-1fa696a7.mintlify.site/docs/video-agent.md) and the agent applies it to everything it builds: scene backgrounds, text treatments, chart palettes, and logo placement. Output ships on-brand without describing your brand in the prompt.

Author a kit in the HeyGen app under **Brand Kit**, or import one from a public website over the API. Either way you get a `brand_kit_id`, and a kit created over the API stays editable in the app.

A brand kit governs how a video **looks**. To control how your terms are **spoken**, pair it with a [brand glossary](https://heygen-1fa696a7.mintlify.site/docs/brand-glossary.md). Video Agent takes both IDs on the same request.

> [!NOTE]
>
> **API reference:** [Create Brand Kit](https://heygen-1fa696a7.mintlify.site/reference/create-brand-kit.md) · [Get Brand Kit](https://heygen-1fa696a7.mintlify.site/reference/get-brand-kit.md) · [List Brand Kits](https://heygen-1fa696a7.mintlify.site/reference/list-brand-kits.md) · [Update Brand Kit](https://heygen-1fa696a7.mintlify.site/reference/update-brand-kit.md) · [Delete Brand Kit](https://heygen-1fa696a7.mintlify.site/reference/delete-brand-kit.md) · [Create Session](https://heygen-1fa696a7.mintlify.site/reference/create-video-agent-session.md) · [Send Message](https://heygen-1fa696a7.mintlify.site/reference/send-message-or-request-revision.md)

## Quickstart

Import a kit from your website:

```bash theme={null}
curl -X POST "https://api.heygen.com/v3/brand-kits" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.acme.com", "name": "Acme Corp" }'
```

Pass the returned `brand_kit_id` to the Video Agent. The ID works right away, while the import finishes:

```bash theme={null}
curl -X POST "https://api.heygen.com/v3/video-agents" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a 45-second explainer about our Q3 product launch.",
    "brand_kit_id": "3f9a1c47b8e24d5fa0c61e8b7d24f6a1"
  }'
```

> [card] [Import a kit](https://heygen-1fa696a7.mintlify.site/docs/brand-kits/import.md)
>
> From a website, then wait for the import.

> [card] [Manage kits](https://heygen-1fa696a7.mintlify.site/docs/brand-kits/manage.md)
>
> List, correct roles, and delete.

> [card] [Apply a kit](https://heygen-1fa696a7.mintlify.site/docs/brand-kits/apply.md)
>
> Brand Video Agent output and re-brand sessions.

## Errors

Brand-kit-specific meanings are below; [Error codes](https://heygen-1fa696a7.mintlify.site/docs/error-codes.md) covers the rest, including `brand_kit_not_ready` for role edits during an import.

| Status | Code | Meaning |
| - | - | - |
| `400` | `invalid_parameter` | On an import, `"URL is not supported"`: use a public page reachable without a login. On an update, `"Provide at least one field to update."` means the body arrived empty. |
| `403` | `forbidden` | Your workspace settings do not allow creating brand kits. |
| `403` | `resource_access_denied` | The kit was shared in from another workspace, which holds updates and deletion. It is still readable and usable. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.