CreateDraft

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/frontapp/main/json-schema/frontapp-create-draft-schema.json",
  "title": "CreateDraft",
  "x-generated": "2026-10-14",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/frontapp-core-api-openapi.yml#/components/schemas/CreateDraft",
  "required": [
    "body"
  ],
  "properties": {
    "author_id": {
      "type": "string",
      "description": "ID of the teammate on behalf of whom the draft will be created. Alternatively, you can supply the author ID as a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1). If omitted, will post as the API Token or Application making the request."
    },
    "to": {
      "type": "array",
      "description": "List of recipient handles who will receive the message once the draft is sent",
      "items": {
        "type": "string"
      }
    },
    "cc": {
      "type": "array",
      "description": "List of recipient handles who will receive a copy of the message once the draft is sent",
      "items": {
        "type": "string"
      }
    },
    "bcc": {
      "type": "array",
      "description": "List of the recipient handles who will receive a blind copy of the message once the draft is sent",
      "items": {
        "type": "string"
      }
    },
    "subject": {
      "type": "string",
      "description": "Subject of the draft."
    },
    "body": {
      "type": "string",
      "description": "Body of the draft"
    },
    "quote_body": {
      "type": "string",
      "description": "Body for the quote that the message is referencing. Only available on email channels."
    },
    "attachments": {
      "description": "Binary data of attached files. Must use `Content-Type: multipart/form-data` if specified. See [example](https://gist.github.com/hdornier/e04d04921032e98271f46ff8a539a4cb) or read more about [Attachments](https://dev.frontapp.com/docs/attachments-1). Max 25 MB.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "binary"
      }
    },
    "mode": {
      "description": "Mode of the draft to create. Can be 'private' (draft is visible to the author only) or 'shared' (draft is visible to all teammates with access to the conversation).",
      "type": "string",
      "enum": [
        "private",
        "shared"
      ],
      "default": "private"
    },
    "signature_id": {
      "description": "ID of the signature to attach to this draft. If null, no signature is attached.",
      "type": "string"
    },
    "should_add_default_signature": {
      "type": "boolean",
      "description": "Whether or not Front should try to resolve a signature for the message. Is ignored if signature_id is included. Default false;"
    }
  }
}