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

# Create Label

`POST /labels`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/labels`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/labels/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new Label

## Request body

- object
  - `name` string, required: The name of the Label. This is the value that will be shown on a tagged record.

## Response `201`

OK

- Label: A Label
  - `id` integer, required
  - `account_id` integer, required
  - `name` string, required: The name of the Label. This is the value used to tag a record.
  - `taggings_count` integer, required: The number of records that have been tagged with this Label.
  - `color` string, required: The hex color of the Label.

## Other responses

- `401`: Request could not be authenticated
- `403`: Insufficient permission to perform this operation
- `422`: Unprocessable Entity
- `500`: Something unexpected happened

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)