Create Inbox

An inbox sends and receives email at an address on one of your domains, such as support@example.com.

The inbox email address on one of your domains. The domain must be verified to send email, and verified to receive email unless forwarding is true.

• name (string) — Internal name for the inbox. Recipients do not see it.

The name recipients see when mail is sent from this inbox. A plain name, not a Name <email> address.

• forwarding (boolean) — When true, Resend provisions a receiving address so you can receive mail without adding an MX record. Defaults to false.

• object (string) — Always inbox.

• id (string) — The ID of the inbox.

• name (string) — Internal name for the inbox. Recipients do not see it.

• email_address (string) — The address of the inbox.

• domain_id (string) — The ID of the domain that owns the address.

• forwarding_address (string | null) — The address to forward mail to when forwarding is enabled. null otherwise.

• friendly_name (string | null) — The name recipients see when mail is sent from this inbox. A plain name, not a Name <email> address.

• unread (number) — The number of unread threads in the inbox.

• created_at (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"
}