---
title: "Create Branding"
method: POST
path: "/v1/brandings"
tags: ["brandings"]
---

# Create Branding

`POST /v1/brandings`

## Request

- Base URL: `https://api.elaan.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elaan.io/v1/brandings`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- CreateBrandingRequest
  - `key` string, required
  - `values` object
  - `from_address` string, nullable
  - `from_name` string, nullable

## Response `201`

Successful Response

- BrandingResponse
  - `key` string, required
  - `values` object, required
  - `is_default` boolean, required: The tenant's fallback brand, used when a trigger names no brand or an unknown one. Exactly one per tenant, provisioned at signup, and it cannot be deleted.
  - `from_address` string, nullable, required
  - `from_name` string, nullable, required

## Other responses

- `402`: The plan's brand cap is reached — upgrade to add more
- `409`: A branding with this key already exists
- `422`: Validation Error

---

[API](https://skmtc.dev/elaan/apis/elaan-api.md) · [All operations](https://skmtc.dev/elaan/apis/elaan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/elaan/apis/elaan-api/revisions/c96a7e6399aa?raw)