{"uid":"cap_-C5RiKMqUFVg9gZh_oojo","slug":"agentmail-drafts-79199f26","name":"AgentMail List Drafts","description":"List Drafts","url":"https://mpp.api.agentmail.to/v0/drafts","method":"GET","headers":{},"bodySchema":{"type":"object","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."},"ascending":{"type":"boolean","title":"Ascending","description":"Sort in ascending temporal order."},"page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"responseSchema":{"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":{"$ref":"#/components/schemas/type_attachments:AttachmentSize"},"filename":{"$ref":"#/components/schemas/type_attachments:AttachmentFilename"},"content_id":{"$ref":"#/components/schemas/type_attachments:AttachmentContentId"},"content_type":{"$ref":"#/components/schemas/type_attachments:AttachmentContentType"},"attachment_id":{"$ref":"#/components/schemas/type_attachments:AttachmentId"},"content_disposition":{"$ref":"#/components/schemas/type_attachments:AttachmentContentDisposition"}}},"title":"DraftAttachments","description":"Attachments in draft."},"in_reply_to":{"type":"string","title":"DraftInReplyTo","description":"ID of message being replied to."},"send_status":{"enum":["scheduled","sending","failed"],"type":"string","title":"DraftSendStatus","description":"Schedule send status of draft."}}},"description":"Ordered by `updated_at` descending."},"next_page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_MEv1kIbvbB_ClSRuMRqLr","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Lists email draft messages in an AgentMail inbox with filtering and pagination support","exampleAgentPrompt":"Show me all drafts in my AgentMail inbox that have the label 'follow-up', sorted from oldest to newest, and return the first 20 results.","exampleUseCases":null,"resultDescription":"Returns a paginated list of draft objects including draft IDs, inbox IDs, subject lines, recipient addresses (to/cc/bcc), text previews, scheduled send times, labels, attachment metadata, and last-updated timestamps, along with a count and optional pagination cursor.","failureModes":["Invalid or expired Bearer token returns 401 Unauthorized","Invalid date-time format for before/after parameters returns 400 Bad Request","Unknown inbox_id or no accessible drafts returns empty list","Invalid page_token causes pagination error","Label filter with no matching drafts returns empty array with count 0"],"whenToPreferThis":"Use this endpoint when an AI agent needs to review, audit, or process unsent email drafts stored in an AgentMail inbox — especially when filtering by time range, labels, or scheduling status. Prefer this over thread or message listing endpoints when specifically working with unsent draft content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:58:31.442Z","isFirstParty":false}