List a mailbox's labels

GET

/v1/email/mailboxes/{mailbox_id}/labels

const labels = await bird.email.mailboxes.labels("mbx_01abc");
console.log(labels.data.map((label) => label.name));

labels = client.email.mailboxes.labels("mbx_01krdgeqcxet5s7t44vh8rt9mg")
for label in labels.data:
    print(label.name)

labels, err := client.Email.Mailboxes.Labels(context.Background(), "mbx_123")
if err != nil {
	log.Fatal(err)
}
for _, l := range labels.Data {
	fmt.Println(l.Name)
}

$labels = $bird->email->mailboxes->labels('mbx_01krdgeqcxet5s7t44vh8rt9mg');
foreach ($labels->getData() ?? [] as $label) {
    echo $label->getName(), "\n";
}

bird email mailboxes labels <mailbox-id>

curl -X GET "https://us1.platform.bird.com/v1/email/mailboxes/{mailbox_id}/labels" \
  -H "Authorization: Bearer $TOKEN"

Resposta200

{
  "data": [
    {
      "name": "inbox",
      "type": "system"
    }
  ]
}

Returns the labels available in a mailbox. First, the built-in system labels:

The placements inbox, archive, spam, blocked, and sent.
trash.
unread.

Then, every custom label currently in use on its conversations and messages. Apply and remove labels through the conversation and message update endpoints. These actions also create and remove custom labels. A custom label exists while at least one message or conversation uses it.

Parâmetros

mailbox_id

string

Mailbox identifier. Starts with mbx_.

Payload de resposta

data

array of object

obrigatório

Mostrar atributos secundários

data.name

string

obrigatório

The label name, as it appears on conversations and messages.

data.type

string

obrigatório

system labels are the built-in placements a message can be in:

Inbox.
Archive.
Spam.
Blocked.
Sent.
Trash.
Unread.

custom labels are the workspace's own tags.

Possible values: system, custom

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Assista ao guiaSetting up your coding agent Entenda o conceitoWhat is an MCP server, and how does an agent use one to send messages?Explore a funcionalidadeCoding agents Siga o percurso de aprendizagemBuild with AI agents

Obtenha um resumo de implementação

const labels = await bird.email.mailboxes.labels("mbx_01abc");
console.log(labels.data.map((label) => label.name));

labels = client.email.mailboxes.labels("mbx_01krdgeqcxet5s7t44vh8rt9mg")
for label in labels.data:
    print(label.name)

labels, err := client.Email.Mailboxes.Labels(context.Background(), "mbx_123")
if err != nil {
	log.Fatal(err)
}
for _, l := range labels.Data {
	fmt.Println(l.Name)
}

$labels = $bird->email->mailboxes->labels('mbx_01krdgeqcxet5s7t44vh8rt9mg');
foreach ($labels->getData() ?? [] as $label) {
    echo $label->getName(), "\n";
}

bird email mailboxes labels <mailbox-id>

curl -X GET "https://us1.platform.bird.com/v1/email/mailboxes/{mailbox_id}/labels" \
  -H "Authorization: Bearer $TOKEN"

Resposta200

{
  "data": [
    {
      "name": "inbox",
      "type": "system"
    }
  ]
}