Create Label
Create a label on an inbox.
A label is a named, colored tag that belongs to one inbox.
Path Parameters
Section titled “Path Parameters”The Inbox ID.
Body Parameters
Section titled “Body Parameters”-
name(string, required) — The name of the label. -
color(string) — The color of the label:cyan,teal,grass,lime,yellow,orange,iris,plum,crimson,bronze, ormauve.
Response Fields
Section titled “Response Fields”-
object(string) — Alwaysinbox_label. -
id(string) — The ID of the label. -
name(string) — The name of the label. -
color(string) — The color of the label. -
created_at(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"
}