> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.

## Summary

Introducing the **Drafts API** – compose and manage email drafts before sending. Create drafts, update them over time, schedule send times, and send when ready. Perfect for agents that need to build messages incrementally, support reply threading, or queue emails for later delivery.

### What's new?

**New endpoints:**

* `GET /drafts` - List all drafts (with optional filters)
* `GET /drafts/{draft_id}` - Get a draft
* `POST /inboxes/{inbox_id}/drafts` - Create a draft in an inbox
* `PATCH /inboxes/{inbox_id}/drafts/{draft_id}` - Update a draft
* `POST /inboxes/{inbox_id}/drafts/{draft_id}/send` - Send a draft
* `DELETE /inboxes/{inbox_id}/drafts/{draft_id}` - Delete a draft

**Draft features:**

* Compose with to, cc, bcc, subject, plain text, and HTML body
* Reply threading via `in_reply_to` and `references`
* Schedule send with `send_at` for delayed delivery
* Attachments and labels
* List and filter drafts by inbox, labels, or time range

### Use cases

Build agents that:

* Compose multi-step replies before sending
* Schedule follow-up emails for optimal delivery
* Queue outbound messages and send in batches
* Edit drafts based on new context or user feedback
* Maintain proper email threads with `in_reply_to`

**`Python`**

```python title="Python"
from agentmail import AgentMail

client = AgentMail(api_key="your-api-key")

# create a draft in an inbox
draft = client.inboxes.drafts.create(
    inbox_id="support@example.com",
    to=["user@example.com"],
    subject="Re: Your request",
    text="We're looking into it.",
    in_reply_to="<message-id@example.com>"
)

# update the draft
client.inboxes.drafts.update(
    inbox_id="support@example.com",
    draft_id=draft.draft_id,
    text="We've resolved your request."
)

# send the draft
client.inboxes.drafts.send(
    inbox_id="support@example.com",
    draft_id=draft.draft_id
)
```

**`TypeScript`**

```typescript title="TypeScript"
import { AgentMail } from "agentmail";

const client = new AgentMail({ apiKey: "your-api-key" });

// create a draft in an inbox
const draft = await client.inboxes.drafts.create("support@example.com", {
  to: ["user@example.com"],
  subject: "Re: Your request",
  text: "We're looking into it.",
  inReplyTo: "<message-id@example.com>",
});

// update the draft
await client.inboxes.drafts.update(
  "support@example.com",
  draft.draftId,
  { text: "We've resolved your request." }
);

// send the draft
await client.inboxes.drafts.send("support@example.com", draft.draftId);
```

Learn more about composing and sending in our [Drafts](https://docs.agentmail.to/core-concepts/drafts) documentation.

> AgentMail is an email API built for AI agents. Create inboxes, send and receive messages, manage threads, and handle webhooks programmatically.