Skip to the documentation
API

List label colours

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

GETapi.openemail.uk/labels/colors

Runs the real call against your workspace, with your own key.

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.