---
title: "Create Label"
method: POST
path: "/user/label"
tags: ["Labels"]
---

# Create Label

`POST /user/label`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/label`
- Auth: HTTP bearer

Create a label to tag your assistants

[Docs](https://docs.famulor.io/api-v1/labels/create)

## Request body

- object
  - `name` string, required: The label name (max 255 characters). Must be unique within your account.
  - `color` 'gray' | 'slate' | 'red' | 'orange' | 'amber' | 'green' | 'teal' | 'blue' | 'purple' | 'pink': A color for the label badge. One of: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`.

## Response `201`

Success Response

- object
  - `message` string: Success message
  - `data` object
    - `id` integer: The unique identifier of the created label
    - `name` string: The label name
    - `color` string: The label color (or `null`)
    - `assistants_count` integer: Number of assistants this label is applied to (always `0` for a new label)

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Validation Error

---

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