Create, list, and edit draft replies on a Front conversation via the Drafts API
domain: dev.frontapp.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Create a reply draft on an existing conversation with POST https://api2.frontapp.com/conversations/{conversation_id}/drafts, supplying body plus optional author_id, to/cc/bcc, subject, quote_body, attachments (multipart, max 25MB), and mode ("private" default or "shared")
Alternatively start a brand-new conversation from a draft with POST https://api2.frontapp.com/channels/{channel_id}/drafts, since Front conversations cannot be created empty
List drafts on a conversation with GET https://api2.frontapp.com/conversations/{conversation_id}/drafts, following the 301 redirect if the conversation has since been merged into another
Edit a draft with PATCH https://api2.frontapp.com/drafts/{draft_id}, including the draft's current version value from the create response to avoid a conflict
Delete a draft with DELETE https://api2.frontapp.com/drafts/{draft_id}, also passing the current version
Known gotchas
Edits and deletes are optimistically locked by a version field — an omitted or stale version produces a conflict error, a real race-condition trap when two integrations touch the same draft
mode defaults to "private" (visible only to the author); shared drafts must be explicitly requested with mode "shared" or the rest of the team won't see them
GET on a conversation's drafts can 301-redirect if the conversation has since been merged, so callers must follow redirects or resolve the canonical conversation ID first
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?