---
title: "Brand kits"
description: "Read-only Brand Kit profiles (voice, labeled colors, pinned library graphics, core pages) for on-brand template authoring. Writes and URL import stay in the dashboard (Settings → Brand)."
url: https://www.unitpost.com/docs/api/brand-kits
section: API reference
updated: 2026-07-31
---
# Brand kits

## Brand kits

> Read-only Brand Kit profiles (voice, labeled colors, pinned library graphics, core pages) for on-brand template authoring. Writes and URL import stay in the dashboard (Settings → Brand).

Full schemas: [OpenAPI 3.1](https://www.unitpost.com/api/v1/openapi.json). HTML reference: https://www.unitpost.com/docs/api/brand-kits.

## Operations

### `GET /api/v1/brand-kits`

List brand kits

Retrieve every Brand Kit profile in the workspace (up to five named profiles). Each profile holds tone, about, voice notes, labeled colors, pinned logo/background library images, and core pages — the primary brand context for on-brand template authoring. Pass `?name=` to filter to one profile by display name (case-insensitive). The response includes `default_id` for the Default profile. Fetch one by id with [Retrieve a brand kit](#get-brand-kits-id). Writes and URL import stay in the dashboard (Settings → Brand). Requires the `templates:read` capability.

### `GET /api/v1/brand-kits/{id}`

Retrieve a brand kit

Retrieve one Brand Kit profile by `id` (`bk_…`), including voice, labeled colors, pinned graphics (`library_image_id` for `/img/{id}` in design TSX), and core pages. List every profile with [List brand kits](#get-brand-kits). Requires the `templates:read` capability.

## Related

- [Domains](https://www.unitpost.com/docs/api/domains): The domains you send from. Add a domain, publish its DNS records, verify it, and manage its tracking and TLS defaults — sending is blocked until the domain verifies.
- [Webhooks](https://www.unitpost.com/docs/api/webhooks): Register HTTPS endpoints that receive signed event deliveries (delivered, bounced, opened, clicked, …). The signing secret is returned once on create; verify the signature on every delivery.
- [API keys](https://www.unitpost.com/docs/api/api-keys): Create and revoke the API keys your integrations authenticate with. These endpoints are session-gated (dashboard cookie + `apikeys:manage`) and NOT usable with a Bearer API key.