> ## Documentation Index
> Fetch the complete documentation index at: https://help.texterchat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Label object

> A label defined in Texter

abels tag chats for filtering, routing and automation. Apply them to chats with [Manage Labels in Chat](/api-reference/labels/manage-labels-in-chat) and filter chats by label in [Search Chats](/api-reference/chats/search-chats).

<Info>
  Returned by: [List All Labels](/api-reference/labels/list-all-labels) · [Get Label Data](/api-reference/labels/get-label-data) · [Create Label](/api-reference/labels/create-label)
</Info>

```json Example label object [expandable]  theme={null}
{
  "id": "hot_lead",
  "name": "HOT LEAD",
  "color": "#2CCCE4"
}
```

## Fields

| Field    | Type      | Description                                                                                                                                                                 |
| -------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`     | `string`  | Unique label ID, 1-100 characters. This is the value stored in `chat.labels`                                                                                                |
| `name`   | `string`  | Display name, 1-100 characters                                                                                                                                              |
| `color`  | `string`  | Full hex color (`#RRGGBB`). Defaults to `#555555` when omitted at creation                                                                                                  |
| `system` | `boolean` | Present and `true` on system labels defined by Texter (e.g. failed-message). System labels cannot be created or deleted via the API; only `name` and `color` can be updated |