Create Inbox
POST
/
inboxes
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.inboxes.create({
emailAddress: 'support@example.com',
name: 'Customer Support',
friendlyName: 'Ada from Support',
});curl -X POST 'https://api.resend.com/inboxes' \
-H 'Authorization: Bearer re_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d $'{
"email_address": "support@example.com",
"name": "Customer Support",
"friendly_name": "Ada from Support"
}'resend inboxes create \
--email_address support@example.com \
--name "Customer Support" \
--friendly_name "Ada from Support"{
"object": "inbox",
"id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
"name": "Customer Support",
"email_address": "support@example.com",
"domain_id": "d91cd9bd-1176-453e-8fc1-35364d380206",
"forwarding_address": null,
"friendly_name": "Ada from Support",
"unread": 0,
"created_at": "2026-08-05T14:03:11.229Z"
}An inbox sends and receives email at an address on one of your domains, such as support@example.com.
Body Parameters
Section titled “Body Parameters”string
Internal name for the inbox. Recipients do not see it.
boolean
When true, Resend provisions a receiving address so you can receive mail without adding an MX record. Defaults to false.
Response Fields
Section titled “Response Fields”string
Always inbox.
string
The ID of the inbox.
string
Internal name for the inbox. Recipients do not see it.
string
The address of the inbox.
string
The ID of the domain that owns the address.
string | null
The address to forward mail to when forwarding is enabled. null otherwise.
string | null
The name recipients see when mail is sent from this inbox. A plain name, not a Name <email> address.
number
The number of unread threads in the inbox.
string
ISO 8601 timestamp when the inbox was created.
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.inboxes.create({
emailAddress: 'support@example.com',
name: 'Customer Support',
friendlyName: 'Ada from Support',
});curl -X POST 'https://api.resend.com/inboxes' \
-H 'Authorization: Bearer re_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d $'{
"email_address": "support@example.com",
"name": "Customer Support",
"friendly_name": "Ada from Support"
}'resend inboxes create \
--email_address support@example.com \
--name "Customer Support" \
--friendly_name "Ada from Support"{
"object": "inbox",
"id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
"name": "Customer Support",
"email_address": "support@example.com",
"domain_id": "d91cd9bd-1176-453e-8fc1-35364d380206",
"forwarding_address": null,
"friendly_name": "Ada from Support",
"unread": 0,
"created_at": "2026-08-05T14:03:11.229Z"
}Was this page helpful?
⌘I