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",
"friendly_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",
"friendly_name": null,
"unread": 0,
"last_received": null
}
]
}
List Inboxes
Retrieve a list of inboxes for the authenticated user.
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",
"friendly_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",
"friendly_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 in
touch if you’re interested in testing this
feature.Once you have access, upgrade your Resend SDK to use the methods on this
page:
npm install resend@6.28.1-preview-inboxes.1
npm install -g resend-cli@2.22.0-preview-inboxes.1
after and before work.
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. A plain name,
not a
Name <email> address.number
The number of unread threads in the inbox.
string | null
ISO 8601 timestamp when a thread in this inbox was last active.
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",
"friendly_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",
"friendly_name": null,
"unread": 0,
"last_received": null
}
]
}
Was this page helpful?
⌘I