List labels
GET
/v1/labelsconst labels = await bird.labels.list();
console.log(labels.data.map((label) => label.name));labels = client.labels.list()
for label in labels.data:
print(label.id, label.name)labels, err := client.Labels.List(context.Background())
if err != nil {
log.Fatal(err)
}
for _, l := range labels.Data {
fmt.Println(l.Id, l.Name)
}$labels = $bird->labels->list();
foreach ($labels->getData() ?? [] as $label) {
echo $label->getId(), ' ', $label->getName(), "\n";
}bird labels listcurl -X GET "https://us1.platform.bird.com/v1/labels" \
-H "Authorization: Bearer $TOKEN"Réponse200
{
"data": [
{
"id": "lbl_01krdgeqcxet5s7t44vh8rt9mg",
"name": "Hot lead",
"color": "#E5484D",
"description": "Inbound sales enquiry from a company. Not support requests or vendors.",
"created_at": "2026-05-20T09:14:52Z",
"updated_at": "2026-05-25T16:42:01Z"
}
]
}
Returns every label in the workspace, ordered by name, in one list without pagination. Each label carries its colour and a description of when to apply it. A workspace creates no new label once it has 100 or more.
Mailbox system labels are a fixed set that every mailbox has, so they are
not in this list: inbox, archive, spam, blocked, sent, trash
and unread. A thread's folder sets inbox, archive or spam, and
its read field sets unread. Deleting a thread moves it to trash and
restoring it moves it back. sent and blocked are assigned automatically.
Contenu de la réponse
dataarray of object
obligatoire
Every label in the workspace, ordered by name.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.