---
title: "List label colours"
description: "The palette the app offers: fourteen solid colours and seven gradients."
url: "https://openemail.uk/docs/api/labels/colors"
area: "API"
category: "Mailbox"
---

# List label colours

The palette the app offers: fourteen solid colours and seven gradients.

`GET /labels/colors`

## GET /labels/colors

The palette the app offers: fourteen solid colours and seven gradients.

## Example

Needs `labels:read`. A fixed catalogue, so there is no paging: fetch it once and keep it.

**curl**

```
curl "$OE/labels/colors" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [
    {
      "object": "label_color",
      "kind": "solid",
      "name": "red",
      "value": "#EF4444",
      "solid": "#EF4444",
      "from": null,
      "to": null,
      "textColor": "#18181B"
    },
    {
      "object": "label_color",
      "kind": "gradient",
      "name": "sunset",
      "value": "gradient:sunset",
      "solid": "#F25E58",
      "from": "#F97316",
      "to": "#EC4899",
      "textColor": "#18181B"
    }
  ]
}
```

> Send `value` as `color.backgroundColor` to use a swatch. A gradient is drawn at 135 degrees from `from` to `to`, and `solid` is one hex for places a gradient cannot go, such as an icon.

> A label may also carry any other hex, set through this API. The app keeps it and offers it back as its own swatch when the label is edited.