{"uid":"cap_uLdg1ZfqDN45800sP7nUH","slug":"agentmail-drafts-ef2073d7","name":"AgentMail Create Draft","description":"Create Draft","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/drafts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"CreateDraftRequest","properties":{"cc":{"type":"array","items":{"type":"string"},"title":"DraftCc","description":"Addresses of CC recipients. In format `username@domain.com` or `Display Name `."},"to":{"type":"array","items":{"type":"string"},"title":"DraftTo","description":"Addresses of recipients. In format `username@domain.com` or `Display Name `."},"bcc":{"type":"array","items":{"type":"string"},"title":"DraftBcc","description":"Addresses of BCC recipients. In format `username@domain.com` or `Display Name `."},"html":{"type":"string","title":"DraftHtml","description":"HTML body of draft."},"text":{"type":"string","title":"DraftText","description":"Plain text body of draft."},"labels":{"type":"array","items":{"type":"string"},"title":"DraftLabels","description":"Labels 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."},"reply_to":{"type":"array","items":{"type":"string"},"title":"DraftReplyTo","description":"Reply-to addresses. In format `username@domain.com` or `Display Name `."},"client_id":{"type":"string","title":"DraftClientId","description":"Client ID of draft."},"attachments":{"type":"array","items":{"type":"object","title":"SendAttachment","properties":{"url":{"type":"string","description":"URL to the attachment."},"content":{"type":"string","description":"Base64 encoded content of attachment."},"filename":{"type":"string","title":"AttachmentFilename","description":"Filename of attachment."},"content_id":{"type":"string","title":"AttachmentContentId","description":"Content ID of attachment."},"content_type":{"type":"string","title":"AttachmentContentType","description":"Content type of attachment."},"content_disposition":{"enum":["inline","attachment"],"type":"string","title":"AttachmentContentDisposition","description":"Content disposition of attachment."}}},"description":"Attachments to include in draft."},"in_reply_to":{"type":"string","title":"DraftInReplyTo","description":"ID of message being replied to."}}},"responseSchema":{"type":"object","title":"Draft","required":["inbox_id","draft_id","labels","updated_at","created_at"],"properties":{"cc":{"type":"array","items":{"type":"string"},"title":"DraftCc","description":"Addresses of CC recipients. In format `username@domain.com` or `Display Name `."},"to":{"type":"array","items":{"type":"string"},"title":"DraftTo","description":"Addresses of recipients. In format `username@domain.com` or `Display Name `."},"bcc":{"type":"array","items":{"type":"string"},"title":"DraftBcc","description":"Addresses of BCC recipients. In format `username@domain.com` or `Display Name `."},"html":{"type":"string","title":"DraftHtml","description":"HTML body of draft."},"text":{"type":"string","title":"DraftText","description":"Plain text body of draft."},"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."},"reply_to":{"type":"array","items":{"type":"string"},"title":"DraftReplyTo","description":"Reply-to addresses. In format `username@domain.com` or `Display Name `."},"client_id":{"type":"string","title":"DraftClientId","description":"Client ID of draft."},"created_at":{"type":"string","format":"date-time","description":"Time at which draft was created."},"references":{"type":"array","items":{"type":"string"},"description":"IDs of previous messages in thread."},"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":{"type":"integer","title":"AttachmentSize","description":"Size of attachment in bytes."},"filename":{"type":"string","title":"AttachmentFilename","description":"Filename of attachment."},"content_id":{"type":"string","title":"AttachmentContentId","description":"Content ID of attachment."},"content_type":{"type":"string","title":"AttachmentContentType","description":"Content type of attachment."},"attachment_id":{"type":"string","title":"AttachmentId","description":"ID of attachment."},"content_disposition":{"enum":["inline","attachment"],"type":"string","title":"AttachmentContentDisposition","description":"Content disposition of attachment."}}},"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."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","priceSource":"unknown","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":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Creates an email draft in a specified AgentMail inbox, with optional scheduling, recipients, attachments, and labels","exampleAgentPrompt":"In my AgentMail inbox 'inbox_abc123', save a draft email to john.doe@example.com with subject 'Project Update' and body 'Hi John, here is the latest update on the project.' — schedule it to send tomorrow at 9am.","exampleUseCases":[{"title":"Prepare templated customer response drafts","prompt":"Create a draft email in my support inbox to customers who haven't responded in 30 days. Use a friendly follow-up template with our logo, CC my manager, and tag it as 'follow-up' so I can batch review them before sending."},{"title":"Schedule bulk outreach emails for campaigns","prompt":"Draft 5 personalized emails to our webinar attendees in the 'outreach' inbox with different names filled in, add our event PDF as an attachment, and schedule them all to send next Monday morning at 8am."},{"title":"Create threaded email responses for review","prompt":"In my support inbox, draft a reply to that customer's complaint message with an apology and resolution offer, CC the customer success team, and mark it as 'urgent' so someone can review it before we send it out."}],"resultDescription":"Returns a Draft object containing the draft_id, inbox_id, to/cc/bcc/reply_to addresses, subject, HTML and plain-text body, labels, preview text, send_at schedule time, references to prior thread messages, client_id, and created_at/updated_at timestamps.","failureModes":["Invalid inbox_id returns 404 not found","Missing or invalid Authorization Bearer token returns 401 unauthorized","Malformed recipient email addresses return 422 validation error","Invalid send_at datetime format returns 422 validation error","Attachment content that is not valid base64 returns 422 validation error","inbox_id path parameter missing causes 400 or 404 error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to compose and save an email for later review or scheduled delivery, rather than sending immediately. Ideal when the agent wants to prepare outgoing emails with rich content (HTML, attachments, labels) that may need human review before sending, or when precise scheduled delivery is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:38:23.808Z","isFirstParty":false,"canonicalSlug":"agentmail-drafts-ef2073d7"}