---
title: "POST /api/v1.0/labels/"
method: POST
path: "/api/v1.0/labels/"
tags: ["labels"]
---

# POST /api/v1.0/labels/

`POST /api/v1.0/labels/`

View and manage labels

## Request body

- LabelRequest — Serializer for Label model.
  - `name` string, required — Name of the label/folder (can use slashes for hierarchy, e.g. 'Work/Projects')
  - `color` string — Color of the label in hex format (e.g. #FF0000)
  - `mailbox` string, uuid, required — Mailbox that owns this label
  - `threads` string[] — Threads that have this label
  - `description` string — Description of the label, used by AI to understand its purpose
  - `is_auto` boolean — Whether this label should be automatically applied by AI

## Response `201`

Created label

- Label — Serializer for Label model.
  - `id` string, uuid, required — primary key for the record as UUID
  - `name` string, required — Name of the label/folder (can use slashes for hierarchy, e.g. 'Work/Projects')
  - `slug` string, required — URL-friendly version of the name
  - `color` string — Color of the label in hex format (e.g. #FF0000)
  - `display_name` string, required
  - `mailbox` string, uuid, required — Mailbox that owns this label
  - `threads` string[] — Threads that have this label
  - `description` string — Description of the label, used by AI to understand its purpose
  - `is_auto` boolean — Whether this label should be automatically applied by AI

## Other responses

- `400` — Invalid input data
- `403` — Permission denied

## Changes

- **2026-05-05** `75dbb02c61c0` — 1 breaking, 9 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `201`
  - added the optional property `color` to the response with the `201` status
  - added the optional property `description` to the response with the `201` status
  - added the optional property `is_auto` to the response with the `201` status
  - …6 more

[Change history](https://skmtc.dev/betagouv/apis/messages-api/changes/api/v1.0/labels/post.md)

---

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