> ## 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.

# Create email draft

> Save an unsent email draft in the specified sending inbox. All content fields are optional. This operation does not send email, create a thread, or consume a sending allowance. The console lists drafts in each inbox and across the organisation.



## OpenAPI

````yaml https://api.openmail.sh/openapi.json post /v1/drafts
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:
    post:
      tags:
        - drafts
      summary: Create email draft
      description: >-
        Save an unsent email draft in the specified sending inbox. All content
        fields are optional. This operation does not send email, create a
        thread, or consume a sending allowance. The console lists drafts in each
        inbox and across the organisation.
      operationId: createDraft
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - inboxId
              properties:
                inboxId:
                  type: string
                  minLength: 1
                  description: >-
                    ID of the inbox that owns and sends this draft. Scoped API
                    keys require an inbox within their scope.
                threadId:
                  type: string
                  minLength: 1
                  description: >-
                    Reply to this thread when the draft is sent. The draft
                    inherits its reply subject and source thread.
                sourceThreadId:
                  type: string
                  minLength: 1
                  description: >-
                    Associate the draft with this conversation in its sending
                    inbox. Omit threadId for a forward or new conversation. For
                    replies, sourceThreadId must match threadId if both are
                    supplied.
                to:
                  type: string
                  format: email
                  maxLength: 320
                cc:
                  type: array
                  maxItems: 100
                  items:
                    type: string
                    format: email
                    maxLength: 320
                bcc:
                  type: array
                  maxItems: 100
                  items:
                    type: string
                    format: email
                    maxLength: 320
                subject:
                  type: string
                  maxLength: 998
                bodyHtml:
                  type: string
                  maxLength: 500000
                  description: >-
                    HTML message body. This is the only accepted body input; the
                    plain-text fallback is generated automatically. Omit for an
                    incomplete draft. Embedded raster images and images at
                    public HTTP(S) URLs on standard ports are imported as
                    attachments. Saved HTML references them by CID.
          multipart/form-data:
            schema:
              type: object
              additionalProperties: false
              required:
                - inboxId
              properties:
                inboxId:
                  type: string
                  minLength: 1
                  description: >-
                    ID of the inbox that owns and sends this draft. Scoped API
                    keys require an inbox within their scope.
                threadId:
                  type: string
                  minLength: 1
                  description: >-
                    Reply to this thread when the draft is sent. The draft
                    inherits its reply subject and source thread.
                sourceThreadId:
                  type: string
                  minLength: 1
                  description: >-
                    Associate the draft with this conversation in its sending
                    inbox. Omit threadId for a forward or new conversation. For
                    replies, sourceThreadId must match threadId if both are
                    supplied.
                to:
                  type: string
                  format: email
                  maxLength: 320
                cc:
                  type: array
                  maxItems: 100
                  items:
                    type: string
                    format: email
                    maxLength: 320
                bcc:
                  type: array
                  maxItems: 100
                  items:
                    type: string
                    format: email
                    maxLength: 320
                subject:
                  type: string
                  maxLength: 998
                bodyHtml:
                  type: string
                  maxLength: 500000
                  description: >-
                    HTML message body. This is the only accepted body input; the
                    plain-text fallback is generated automatically. Omit for an
                    incomplete draft. Embedded raster images and images at
                    public HTTP(S) URLs on standard ports are imported as
                    attachments. Saved HTML references them by CID.
                inlineImages:
                  type: array
                  items:
                    type: string
                    format: binary
                  description: >-
                    Upload each image with filename inline-<UUID>@openmail and
                    reference it as cid:inline-<UUID>@openmail in bodyHtml. The
                    total attachment limit is 25 MB.
                attachments:
                  type: array
                  items:
                    type: string
                    format: binary
                  description: Regular file attachments.
      responses:
        '201':
          description: Saved unsent draft
          content:
            application/json:
              schema:
                description: Saved unsent draft
                type: object
                required:
                  - id
                  - inboxId
                  - to
                  - cc
                  - bcc
                  - subject
                  - bodyText
                  - bodyHtml
                  - createdAt
                  - updatedAt
                properties:
                  id:
                    type: string
                  inboxId:
                    type: string
                  threadId:
                    type: string
                    description: Thread this draft will reply to when sent.
                    nullable: true
                  sourceThreadId:
                    type: string
                    description: Conversation this draft was composed from.
                    nullable: true
                  attachments:
                    type: array
                    items:
                      type: object
                      required:
                        - filename
                        - contentType
                        - sizeBytes
                      properties:
                        filename:
                          type: string
                        contentType:
                          type: string
                        sizeBytes:
                          type: integer
                        contentId:
                          type: string
                          description: >-
                            Identifier referenced by cid: in bodyHtml for an
                            inline attachment.
                        url:
                          type: string
                  to:
                    type: string
                    nullable: true
                  cc:
                    type: array
                    items:
                      type: string
                  bcc:
                    type: array
                    items:
                      type: string
                  subject:
                    type: string
                  bodyText:
                    type: string
                    nullable: true
                  bodyHtml:
                    type: string
                    nullable: true
                  createdAt:
                    type: string
                    format: date-time
                  updatedAt:
                    type: string
                    format: date-time
        '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'
        '413':
          description: Attachment size limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Account storage limit reached
          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.