Read, send, reply to, and manage emails in a tenant's connected mailbox. Only available for OAuth email configurations (Microsoft365/Google) that have ReadEnabled set to true. Conversations provide a thread-grouped view, while Messages provide a flat list. Supports filtering by direction (inbound/outbound) and search by subject or sender. Sending and replying requires SendEnabled to be true on the configuration. Includes OAuth reconnection for expired or misconfigured connections.

Create Draft

POST /tenants/{tenant}/email-configs/{code}/drafts

Creates a new draft via the email provider. The configuration must have ReadEnabled set to true. The returned UniqueId is used for subsequent Update/Send/Discard calls.

Parameters

Name	Type	Description
tenant*	path string	The Tenant.Code
The Tenant.Code
code*	path string

Request Body*

CreateMailboxDraftRequest

{
  "subject": "string",
  "htmlBody": "string",
  "plainTextBody": "string",
  "toRecipients": [
    {
      "email": "...",
      "name": "..."
    }
  ],
  "ccRecipients": [
    {
      "email": "...",
      "name": "..."
    }
  ]
}

Responses

200 OK

CreateDraftResponse

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found