---
search:
  tags:
    - Colours
    - POST
seo:
  description: >-
    Adds a label to the palette. name is the join key products and events use;…
    Reference for the POST /api/v1/colors endpoint in the Bloomcount Public API
    API.
sidebar:
  label: Create a colour
  badge: POST
title: Create a colour
type: openapi-operation
---
Adds a label to the palette. `name` is the join key products and events use; `hex` is how it renders in the
app.

**Errors**

- `422 color_name_required` — no name, or a blank one.
- `409 color_name_taken` — that label already exists on the tenant.
- `422 invalid_hex_format` — `hex` isn't a valid hex colour.

<Operation source="reference" id="post-api-v1-colors" />