List Labels
GET
/
inboxes
/
:inbox_id
/
labels
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.inboxes.labels.list({
inboxId: 'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
});curl -X GET 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1/labels' \
-H 'Authorization: Bearer re_xxxxxxxxx'resend inboxes labels list --inbox_id b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1{
"object": "list",
"data": [
{
"id": "2a8b4c6d-1e3f-4a5b-9c7d-8e0f1a2b3c4d",
"name": "Billing",
"color": "cyan",
"created_at": "2026-08-01T09:12:03.004Z"
},
{
"id": "7f9c1d2e-4a6b-4c3d-8e15-9b0a7c6d5e34",
"name": "Urgent",
"color": "crimson",
"created_at": "2026-08-05T14:07:42.881Z"
}
]
}Returns every label on the inbox, oldest first.
Path Parameters
Section titled “Path Parameters”Response Fields
Section titled “Response Fields”string
Always list.
array
The labels on the inbox, oldest first.
Hide properties
string
The ID of the label.
string
The name of the label.
string
The color of the label: cyan, teal, grass, lime, yellow, orange, iris, plum, crimson, bronze, or mauve.
string
ISO 8601 timestamp when the label was created.
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.inboxes.labels.list({
inboxId: 'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
});curl -X GET 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1/labels' \
-H 'Authorization: Bearer re_xxxxxxxxx'resend inboxes labels list --inbox_id b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1{
"object": "list",
"data": [
{
"id": "2a8b4c6d-1e3f-4a5b-9c7d-8e0f1a2b3c4d",
"name": "Billing",
"color": "cyan",
"created_at": "2026-08-01T09:12:03.004Z"
},
{
"id": "7f9c1d2e-4a6b-4c3d-8e15-9b0a7c6d5e34",
"name": "Urgent",
"color": "crimson",
"created_at": "2026-08-05T14:07:42.881Z"
}
]
}Was this page helpful?
⌘I