> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openmail.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Send email draft

> Send a saved draft from its owning inbox using its stored recipients and content. Read the draft first and pass its exact updatedAt value. Stale versions return 409. The draft is removed only after successful sending. Failed or pending attempts retain it. Requires MCP send scope. Uses the same delivery policies, limits, and duplicate-send protection as the console.



## OpenAPI

````yaml https://api.openmail.sh/openapi.json post /v1/drafts/{draftId}/send
openapi: 3.0.3
info:
  title: OpenMail API
  description: >-
    Email infrastructure API for AI agents. Create inboxes, send and receive
    email, and get real-time notifications via webhooks.
  version: 1.0.0
  license:
    name: Proprietary
servers:
  - url: https://api.openmail.sh
security:
  - bearerAuth: []
tags:
  - name: pods
    description: Isolated sub-accounts for your end users or tenants
  - name: inboxes
    description: Email inboxes and their webhook configuration
  - name: domains
    description: >-
      Custom domains: add your own sending/receiving domain, publish DNS, and
      verify it
  - name: owned-domains
    description: >-
      Domains your organisation controls but does not send from. Prove ownership
      with one TXT record and mail to their addresses stops counting toward the
      cold outreach limits.
  - name: messages
    description: Sending and listing messages
  - name: drafts
    description: Create, view, edit and send saved email drafts
  - name: threads
    description: Conversation threads and read status
  - name: attachments
    description: Downloading and extracting text from attachments
  - name: policy
    description: >-
      Correspondent policy — provider-enforced allow/block rules and allowlist
      mode, scoped per account, pod, or inbox. Account-wide key only.
  - name: limits
    description: >-
      Sending limits: today's cold outreach caps on new recipients, per account,
      inbox, and domain, and what raises them
  - name: webhooks
    description: >-
      Webhook endpoints: where events are sent, how each request is
      authenticated, and the delivery log. Account-wide key only.
  - name: feedback
    description: Reporting bugs, friction, and feature requests to the OpenMail team
paths:
  /v1/drafts/{draftId}/send:
    post:
      tags:
        - drafts
      summary: Send email draft
      description: >-
        Send a saved draft from its owning inbox using its stored recipients and
        content. Read the draft first and pass its exact updatedAt value. Stale
        versions return 409. The draft is removed only after successful sending.
        Failed or pending attempts retain it. Requires MCP send scope. Uses the
        same delivery policies, limits, and duplicate-send protection as the
        console.
      operationId: sendDraft
      parameters:
        - schema:
            type: string
            minLength: 1
          in: path
          name: draftId
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - updatedAt
              properties:
                inboxId:
                  type: string
                  minLength: 1
                  description: If supplied, must match the inbox that owns the draft.
                updatedAt:
                  type: string
                  format: date-time
                  description: Exact updatedAt from the draft you reviewed.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - messageId
                  - threadId
                  - status
                properties:
                  messageId:
                    type: string
                  threadId:
                    type: string
                  status:
                    type: string
                  providerMessageId:
                    type: string
                    nullable: true
        '400':
          description: Invalid draft or pagination
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing, invalid, or expired credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Inbox is outside the API key scope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Inbox or draft not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Draft changed or sending is still in progress
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Sending blocked by content, recipient, or account policy
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Sending limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: Delivery failed; the draft is retained
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      additionalProperties: true
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.