create_draft
Save a draft email in a connected mailbox (does NOT send — it lands in the Drafts folder for the user to review and send). To draft a REPLY (answering an email the user got), ALWAYS pass reply_to_message_id — never a new message with a "Re:" subject; the id comes (from list_inbox/get_email on the same mailbox): the draft is saved inside that conversation, addressed to the sender with a "Re:" subject and the original message quoted below your text (Gmail and Outlook), so to/subject aren't needed and body should hold only the new reply text. body is Markdown: write links as [Pay invoice](https://…); a bare URL is sent as a clickable "Link". to = list of recipients; optional cc = list of addresses to copy; optional provider ('microsoft'|'google') and account (email/connection_id). The mailbox's signature (Email settings) is added per the user's saved default; pass include_signature to override. Optional attachments = [{filename, content_base64, content_type}] for small inline files, and/or file_ids = file ids from Files (list_doc_files; upload local files first with create_upload_link), and/or invoice_ids = Stripe invoice ids to attach their PDFs (finalized invoices). 25 MB total. Optional from_address sends as one of that mailbox's aliases, as the user names it (e.g. account=christian@okeke.us, from_address=finance@okeke.us).
Parameters
- body (string, required)
- to (array)
- subject (string)
- cc (array)
- reply_to_message_id (string)
- attachments (array)
- file_ids (array)
- invoice_ids (array)
- provider (string)
- account (string)
- include_signature (boolean)
- from_address (string)