List Drafts

Unsent drafts, most recently updated first.

The Inbox ID.

• limit (number) — Number of drafts to return. Default is 20, maximum is 100, minimum is 1.

• after (string) — The ID of the last draft on the current page. Returns the next, older page.

• before (string) — The ID of the first draft on the current page. Returns the previous, newer page.

• object (string) — Always list.

• has_more (boolean) — Whether more drafts exist beyond this page. Pass the last draft's id as after to continue.

• data (array) — The drafts on this page.

  properties

  • id (string) — The ID of the draft.
  • type (string) — standalone for a new conversation, or reply.
  • to (string[] | null) — Recipients.
  • cc (string[]) — CC recipients.
  • bcc (string[]) — BCC recipients.
  • subject (string | null) — The subject.
  • snippet (string | null) — A short preview of the body.
  • thread_id (string | null) — The Thread ID when this draft is a reply. null otherwise.
  • reply_to_email_id (string | null) — The Email ID being replied to. null otherwise.
  • updated_at (string) — ISO 8601 timestamp when the draft was last saved.

import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

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

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

resend inboxes drafts list --inbox_id b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "c3a1e8b4-2d5f-4a7c-9e10-6b8d7f5a4c32",
      "type": "standalone",
      "to": ["ada@example.org"],
      "cc": [],
      "bcc": [],
      "subject": "Refund for order 1041",
      "snippet": "Refund issued for order 1041.",
      "thread_id": null,
      "reply_to_email_id": null,
      "updated_at": "2026-08-05T14:12:04.110Z"
    }
  ]
}