{"uid":"cap_9bVaQ4fL6_LWTzAQFO1jO","slug":"agentmail-create-draft-620e8b44","name":"AgentMail Create Draft","description":"Create a new draft in an inbox. The draft can be edited later and sent with Send Draft.","url":"https://x402.orthogonal.com/agentmail/v0/inboxes/x402test1786260932@agentmail.to/drafts","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"cc":{"type":"array","description":"CC recipient email addresses."},"to":{"type":"array","description":"Recipient email addresses as an array of strings."},"bcc":{"type":"array","description":"BCC recipient email addresses."},"html":{"type":"string","description":"HTML body of the draft."},"text":{"type":"string","description":"Plain text body of the draft."},"labels":{"type":"array","description":"Labels to tag the draft."},"headers":{"type":"object","description":"Custom email headers as key-value pairs."},"subject":{"type":"string","description":"Email subject line."},"reply_to":{"type":"array","description":"Reply-to addresses."},"attachments":{"type":"array","description":"Array of attachment objects: {filename, content_type, content (base64)} or {filename, content_type, url}."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","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":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZrsXfLiwqv_rIIWtcumrl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a new email draft in a specified AgentMail inbox that can be edited and sent later.","exampleAgentPrompt":"Save a new email draft in my AgentMail inbox at x402test1786260932@agentmail.to with the subject 'Project Update' and a body saying 'Hi team, here is the latest status on the project — I'll send this after final review.'","exampleUseCases":[{"title":"Draft outreach email before review","prompt":"Create a draft email in my agentmail inbox x402test1786260932@agentmail.to addressed to client@example.com with subject 'Partnership Proposal' and the body 'Hello, we'd love to explore a collaboration — let me know your availability.' I want to look it over before sending."},{"title":"Queue agent-generated newsletter draft","prompt":"Draft a newsletter email in the x402test1786260932@agentmail.to inbox with subject 'Weekly AI News Roundup' and a body summarizing today's top AI headlines — I'll edit it and send it out later this afternoon."},{"title":"Stage automated reply for human approval","prompt":"Compose a draft reply in my agentmail inbox for a support ticket — subject should be 'Re: Your Request #4821' and the body should say 'Thank you for reaching out. We're looking into your issue and will follow up within 24 hours.' Hold it as a draft so I can approve it first."}],"resultDescription":"Returns a draft object containing the newly created draft's ID, the associated inbox, and the draft content fields (subject, body, recipients), which can be used to reference the draft for editing or sending via the Send Draft endpoint.","failureModes":["Invalid or non-existent inbox ID returns 404","Malformed request body (missing required fields) returns 400","Authentication/payment failure returns 402","Rate limiting may return 429 if too many drafts are created rapidly","Server-side errors return 500"],"whenToPreferThis":"Choose this endpoint when you need to stage an outgoing email for later review or editing before sending — especially useful in agentic workflows where a human-in-the-loop approval step is required before delivery. Prefer this over directly sending when the email content needs to be verified, personalized, or approved post-generation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:56:15.170Z","isFirstParty":false}