---
title: "bird labels create"
description: "Create a label"
canonical: "https://bird.com/docs/cli/reference/labels-create"
---

# `bird labels create`

## Usage

```bash
bird labels create <name> [flags]
```

## Description

Create a label

Add a label to the workspace's catalogue with an optional `#RRGGBB` colour and a description of when to apply it. Names are unique regardless of case, and system names such as inbox, sent, unread, open and assigned are reserved. Creating a label fails once the workspace has 100.

Build the request from the &lt;name> argument and flags, a JSON LabelCreate body via
--body-file ("-" reads stdin), or both — an inline value overrides the matching
body field. Run --example to print a ready-to-edit body, or --dry-run to print
the resolved request without sending it.

## Examples

```bash
# print the body shape (no credentials needed)
bird labels create --example

# the body it prints:
```

```json
{
  "color": "#E5484D",
  "description": "Inbound sales enquiry from a company. Not support requests or vendors.",
  "name": "Hot lead"
}
```

## Options

#### Request

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--body-file`       | Read the JSON request body from this file; "-" reads stdin   |
| `--example`         | Print a complete example request body, then exit             |
| `--dry-run`         | Print the resolved request without sending it, then exit     |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |

#### Options

| Name                | Description                                                                           |
| ------------------- | ------------------------------------------------------------------------------------- |
| `--color`           | The label colour as a #RRGGBB hex value.                                              |
| `--description`     | When to apply the label. People and agents read it when they decide which label fits. |
| `--response-schema` | Print the fields this command returns, then exit                                      |

## Related

| Name                                                      | Description    |
| --------------------------------------------------------- | -------------- |
| [`bird labels delete`](/docs/cli/reference/labels-delete) | Delete a label |
| [`bird labels get`](/docs/cli/reference/labels-get)       | Get a label    |
| [`bird labels list`](/docs/cli/reference/labels-list)     | List labels    |
| [`bird labels update`](/docs/cli/reference/labels-update) | Update a label |

## Related resources

- [What is omnichannel vs multichannel messaging?](/explained/engagement/what-is-omnichannel-vs-multichannel) (answer)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=omnichannel)
