Skip to main content

Create a label

Create a label.

Parameters​

title
string
Title of the label.
hex_color
string
required
Color of the label, in hexadecimal format (e.g., #FF00FF).

Returns​

Returns the created label object. Throws an error if some parameters are not valid.

post
/api/boards/{id}/labels
curl -X POST https://{workspace}.kitchen.co/api/boards/{id}/labels \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Bearer {API_KEY}'
Response
{
  "id": "lbl_5b521cf4562a5ba739fc72a8",
  "color": "#f9d0d9",
  "title": null,
  "createdAt": "2025-06-16T11:25:31+00:00",
  "updatedAt": "2025-06-16T11:25:31+00:00"
}