---
title: "Create a brand"
method: POST
path: "/v1/brand/create"
tags: ["Brands"]
---

# Create a brand

`POST /v1/brand/create`

Creates a BoldSign brand profile that can be used to customize signing pages, email notifications, and document signing workflows.

## Request body

- CreateBrandRequest
  - `brandName` string, required — Display name of the brand that appears in BoldSign signing workflows.
  - `brandColor` string — Primary brand color in hexadecimal format.
  - `logoUrl` string, uri — Public HTTPS URL of the brand logo.
  - `emailDisplayName` string — Display name used in branded email notifications.
  - `emailReplyTo` string, email — Reply-to email address used for branded signing emails.

## Response `200`

Brand created successfully.

- CreateBrandResponse
  - `brandId` string, required — Unique identifier of the created BoldSign brand.
  - `brandName` string, required — Display name of the created brand.
  - `status` 'created', required — Creation status of the brand.

## Other responses

- `400` — Bad request. The request contains invalid or missing fields.
- `401` — Unauthorized. The API key is missing or invalid.
- `404` — Not found. The requested resource does not exist.
- `429` — Rate limit exceeded. Retry after the specified delay.
- `500` — Internal server error. Retry using exponential backoff.
- `502` — Bad gateway. Retry after a short delay using exponential backoff.
- `503` — Service unavailable. Wait and retry later.
- `504` — Gateway timeout. Retry using exponential backoff.

---

[API](https://skmtc.dev/boldsign/apis/boldsign-api.md) · [All operations](https://skmtc.dev/boldsign/apis/boldsign-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/boldsign/boldsign-api/revisions/1bb4907cf4e3/schema)