import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.inboxes.list();
curl -X GET 'https://api.resend.com/inboxes' \
-H 'Authorization: Bearer re_xxxxxxxxx'
resend inboxes list
{
"object": "list",
"has_more": false,
"data": [
{
"id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
"name": "Customer Support",
"email_address": "support@example.com",
"from_name": "Ada from Support",
"unread": 3,
"last_received": "2026-08-05T14:03:11.229Z"
},
{
"id": "1c5e0f3a-6b21-4d9a-8e77-5c0a9d8b4e12",
"name": "billing@example.com",
"email_address": "billing@example.com",
"from_name": null,
"unread": 0,
"last_received": null
}
]
}
List Inboxes
Retrieve a list of inboxes for the team.
GET
/
inboxes
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.inboxes.list();
curl -X GET 'https://api.resend.com/inboxes' \
-H 'Authorization: Bearer re_xxxxxxxxx'
resend inboxes list
{
"object": "list",
"has_more": false,
"data": [
{
"id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
"name": "Customer Support",
"email_address": "support@example.com",
"from_name": "Ada from Support",
"unread": 3,
"last_received": "2026-08-05T14:03:11.229Z"
},
{
"id": "1c5e0f3a-6b21-4d9a-8e77-5c0a9d8b4e12",
"name": "billing@example.com",
"email_address": "billing@example.com",
"from_name": null,
"unread": 0,
"last_received": null
}
]
}
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
after and before work. The
cursors take an inbox ID. A value that is not a UUID returns a 422, and an
unknown ID returns a 404.
The list items carry fewer fields than a single inbox. Retrieve an
inbox to get all its fields.
Response Fields
string
Always
list.boolean
Whether more inboxes exist beyond this page.
array
The inboxes on this page.
Hide properties
Hide properties
string
The ID of the inbox.
string | null
Internal name for the inbox. Recipients do not see it.
string
The address of the inbox.
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.
string | null
ISO 8601 timestamp of the newest received email in the Inbox folder.
null when the folder has no received email.import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.inboxes.list();
curl -X GET 'https://api.resend.com/inboxes' \
-H 'Authorization: Bearer re_xxxxxxxxx'
resend inboxes list
{
"object": "list",
"has_more": false,
"data": [
{
"id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
"name": "Customer Support",
"email_address": "support@example.com",
"from_name": "Ada from Support",
"unread": 3,
"last_received": "2026-08-05T14:03:11.229Z"
},
{
"id": "1c5e0f3a-6b21-4d9a-8e77-5c0a9d8b4e12",
"name": "billing@example.com",
"email_address": "billing@example.com",
"from_name": null,
"unread": 0,
"last_received": null
}
]
}
Was this page helpful?
⌘I