Expose Label Custom Field color (hex) values in the API response
H
Hiroshi Furutani
Title: Expose Label Custom Field color (hex) values in the API response
Category: API / Custom Fields
Description:
Currently, when retrieving Labels-type Custom Field definitions via the API (e.g., Get Accessible Custom Fields or Get List/Folder/Space Custom Fields), the response includes each label option's id and value (name), but does not include the color associated with each label.
In the ClickUp UI, label colors are a core part of how users visually distinguish categories. However, this color information is completely absent from the API, making it impossible for integrations and automations to faithfully reproduce the visual representation that users rely on.
Real-world problem:
I manage a large project (130+ tasks) with multiple Labels fields used for team/role assignment (主担当, 副担当, etc.), each containing 19 label options with carefully chosen colors for quick visual identification. When I try to export the task list to PDF (via ClickUp Brain or external tools), the label badges cannot be rendered in the correct colors because the API simply doesn't provide them.
The only workaround today is to manually extract each label's hex color from the UI (e.g., by inspecting elements or taking screenshots) and provide them to the export tool by hand, every single time the colors change. This defeats the purpose of having an API.
What the API currently returns:
{
"id": "ca5e1bc7-...",
"name": "主担当",
"type": "labels",
"options": [
{ "id": "8aa55602-...", "label": "企画G" },
{ "id": "3df84111-...", "label": "ライフ・物材U" }
]
}
What it should return:
{
"id": "ca5e1bc7-...",
"name": "主担当",
"type": "labels",
"options": [
{ "id": "8aa55602-...", "label": "企画G", "color": "#0091ff" },
{ "id": "3df84111-...", "label": "ライフ・物材U", "color": "#30a46c" }
]
}
Use cases enabled by this change:
Accurate PDF/report generation with color-coded label badges matching the ClickUp UI
External dashboards and BI tools that reflect the same visual language as ClickUp
ClickUp Brain integrations that can render faithful visual exports without manual color input
Automation workflows that reference label colors for conditional logic or notifications
Additional note: This also applies to ClickUp Brain's internal API access. Brain currently cannot read label colors either, which limits its ability to generate accurate visual exports, a feature that would otherwise be a great showcase of Brain's capabilities.
This seems like a small, non-breaking addition to the existing API response schema that would unlock significant value.
Log In