Retrieve Inbox

import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.inboxes.get(
  'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
);

curl -X GET 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

resend inboxes get b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1

{
  "object": "inbox",
  "id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
  "name": "Customer Support",
  "email_address": "support@example.com",
  "domain_id": "d91cd9bd-1176-453e-8fc1-35364d380206",
  "receiving_address": null,
  "from_name": "Ada from Support",
  "unread": 3,
  "drafts": 2,
  "last_received": "2026-08-05T14:03:11.229Z",
  "created_at": "2026-08-01T09:12:44.512Z"
}

GET

inboxes

:inbox_id

import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.inboxes.get(
  'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
);

curl -X GET 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

resend inboxes get b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1

{
  "object": "inbox",
  "id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
  "name": "Customer Support",
  "email_address": "support@example.com",
  "domain_id": "d91cd9bd-1176-453e-8fc1-35364d380206",
  "receiving_address": null,
  "from_name": "Ada from Support",
  "unread": 3,
  "drafts": 2,
  "last_received": "2026-08-05T14:03:11.229Z",
  "created_at": "2026-08-01T09:12:44.512Z"
}

Inboxes are currently in private beta and only available to a limited number of users. The response shape might change before GA.Get early access if you’re interested in testing this feature.Once you have access, upgrade your Resend SDK to use the new methods:

npm install resend@6.33.0

npm install -g resend-cli@2.25.0

Path Parameters

Response Fields

string

Always inbox.

string

The ID of the inbox.

string

Internal name for the inbox. Recipients do not see it. Falls back to the inbox email address.

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. null when not set.

number

The number of unread threads in the Inbox folder.

number

The number of unsent drafts.

string | null

ISO 8601 timestamp of the newest received email in the Inbox folder. null when the folder has no received email.

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.get(
  'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
);

curl -X GET 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

resend inboxes get b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1

{
  "object": "inbox",
  "id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
  "name": "Customer Support",
  "email_address": "support@example.com",
  "domain_id": "d91cd9bd-1176-453e-8fc1-35364d380206",
  "receiving_address": null,
  "from_name": "Ada from Support",
  "unread": 3,
  "drafts": 2,
  "last_received": "2026-08-05T14:03:11.229Z",
  "created_at": "2026-08-01T09:12:44.512Z"
}

API Reference

Sending

Receiving

Inboxes

Inbox Labels

Inbox Threads

Inbox Drafts

Inbox Agent

Broadcasts

Automations

Events

Templates

Contacts

Contact Properties

Contact Imports

Segments

Topics

Audiences

Domains

Logs

Usage

API Keys

Suppressions

Authorized Apps

Webhooks

OAuth

Retrieve Inbox

Path Parameters

Response Fields

​Path Parameters

​Response Fields

Path Parameters

Response Fields