Create Label
POST
/
inboxes
/
:inbox_id
/
labels
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.inboxes.labels.create({
inboxId: 'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
name: 'Urgent',
color: 'crimson',
});curl -X POST 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1/labels' \
-H 'Authorization: Bearer re_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d $'{
"name": "Urgent",
"color": "crimson"
}'resend inboxes labels create \
--inbox_id b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1 \
--name Urgent \
--color crimson{
"object": "inbox_label",
"id": "7f9c1d2e-4a6b-4c3d-8e15-9b0a7c6d5e34",
"name": "Urgent",
"color": "crimson",
"created_at": "2026-08-05T14:07:42.881Z"
}A label is a named, colored tag that belongs to one inbox.
Path Parameters
Section titled “Path Parameters”Body Parameters
Section titled “Body Parameters”string
required
The name of the label.
string
The color of the label: cyan, teal, grass, lime, yellow, orange, iris, plum, crimson, bronze, or mauve.
Response Fields
Section titled “Response Fields”string
Always inbox_label.
string
The ID of the label.
string
The name of the label.
string
The color of the label.
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.create({
inboxId: 'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
name: 'Urgent',
color: 'crimson',
});curl -X POST 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1/labels' \
-H 'Authorization: Bearer re_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d $'{
"name": "Urgent",
"color": "crimson"
}'resend inboxes labels create \
--inbox_id b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1 \
--name Urgent \
--color crimson{
"object": "inbox_label",
"id": "7f9c1d2e-4a6b-4c3d-8e15-9b0a7c6d5e34",
"name": "Urgent",
"color": "crimson",
"created_at": "2026-08-05T14:07:42.881Z"
}Was this page helpful?
⌘I