---
search:
  tags:
    - Inboxes
    - POST
seo:
  description: >-
    A named, colored tag of one inbox: at most 100, names unique regardless of…
    Reference for the POST /inboxes/{inbox_id}/labels endpoint in the
    BillionSend API.
sidebar:
  label: Create a label
  badge: POST
title: Create a label
type: openapi-operation
---
A named, colored tag of one inbox: at most 100, names unique regardless of case. A color is picked when omitted.

`POST /inboxes/{inbox_id}/labels`

**Request body** (`application/json`, required)

- `name` (string, required) — 1-64 characters, unique in the inbox regardless of case
- `color` (string) — #RRGGBB; a color is picked when omitted

Request body example:

```json
{
  "name": "string",
  "color": "string"
}
```

**Responses**

- `201` — Label created
- `401` — Missing, malformed, unknown or revoked API key
- `404` — Not found
- `422` — Validation error, a duplicate name or the 100-label cap
- `429` — Over the rate limit (rate\_limit\_exceeded, with Retry-After)

Response example, 201:

```json
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "color": "string",
  "created_at": "string",
  "object": "inbox_label"
}
```
