# AgentMail List Drafts

> AgentMail List Drafts is a free API for AI agents from AgentMail at mpp.api.agentmail.to, free · handshake required, status unknown (last checked 2026-10-11).

Lists all email drafts within a specified AgentMail pod, with filtering and pagination support

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/pods/:pod_id/drafts?utm_source=zero.xyz
- Price: free · handshake required
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 1
- Provider: AgentMail
- Docs: https://docs.agentmail.to
- Website: https://agentmail.to
- Tags: email, inboxes, domains, drafts, threads, webhooks, messaging, ai, social
- Canonical page: https://www.zero.xyz/c/agentmail-drafts-c5b907c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UsQjXJHJNP3dFPdb45U1c

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentmail-drafts-c5b907c3
```

Example prompt: Show me all the email drafts in my AgentMail pod 'pod_abc123' — give me the 20 most recent ones, filtered to only those with the label 'outreach'.

## When to prefer this

Use this endpoint when you need to inspect, audit, or enumerate unsent email drafts managed by an AI agent within an AgentMail pod. Prefer this over thread or message listing endpoints when you specifically want draft (unsent) content. Best for agents that manage outbound email queues, review scheduled sends, or need to check draft state before sending.

## Known failure modes

- Invalid or missing pod_id returns 404 not found
- Invalid Authorization token returns 401 unauthorized
- Malformed date-time format for before/after returns 422 validation error
- Invalid page_token returns 400 bad request
- Pod with no drafts returns empty drafts array with count 0

## How this service works

List Drafts

## Output

Returns a paginated list of draft objects for the specified pod, each including draft_id, inbox_id, subject, to/cc/bcc recipients, preview text, labels, scheduled send time, last updated timestamp, and attachment metadata, along with total count and pagination token.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "pod_id"
 ],
 "properties": {
  "after": {
   "type": "string",
   "title": "After",
   "format": "date-time",
   "description": "Timestamp after which to filter by."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "before": {
   "type": "string",
   "title": "Before",
   "format": "date-time",
   "description": "Timestamp before which to filter by."
  },
  "labels": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Labels",
   "description": "Labels to filter by."
  },
  "pod_id": {
   "type": "string",
   "title": "PodId",
   "description": "ID of pod."
  },
  "ascending": {
   "type": "boolean",
   "title": "Ascending",
   "description": "Sort in ascending temporal order."
  },
  "page_token": {
   "type": "string",
   "title": "PageToken",
   "description": "Page token for pagination."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ListDraftsResponse",
 "required": [
  "count",
  "drafts"
 ],
 "properties": {
  "count": {
   "type": "integer",
   "title": "Count",
   "description": "Number of items returned."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "drafts": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "DraftItem",
    "required": [
     "inbox_id",
     "draft_id",
     "labels",
     "updated_at"
    ],
    "properties": {
     "cc": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "DraftCc",
      "description": "Addresses of CC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."
     },
     "to": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "DraftTo",
      "description": "Addresses of recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."
     },
     "bcc": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "DraftBcc",
      "description": "Addresses of BCC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."
     },
     "labels": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "DraftLabels",
      "description": "Labels of draft."
     },
     "preview": {
      "type": "string",
      "title": "DraftPreview",
      "description": "Text preview of draft."
     },
     "send_at": {
      "type": "string",
      "title": "DraftSendAt",
      "format": "date-time",
      "description": "Time at which to schedule send draft."
     },
     "subject": {
      "type": "string",
      "title": "DraftSubject",
      "description": "Subject of draft."
     },
     "draft_id": {
      "type": "string",
      "title": "DraftId",
      "description": "ID of draft."
     },
     "inbox_id": {
      "type": "string",
      "title": "InboxId",
      "description": "The ID of the inbox."
     },
     "updated_at": {
      "type": "string",
      "title": "DraftUpdatedAt",
      "format": "date-time",
      "description": "Time at which draft was last updated."
     },
     "attachments": {
      "type": "array",
      "items": {
       "type": "object",
       "title": "Attachment",
       "required": [
        "attachment_id",
        "size"
       ],
       "properties": {
        "size": {

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-drafts-c5b907c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.api.agentmail.to](https://www.zero.xyz/host/mpp.api.agentmail.to/llms.txt)