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.

Update Draft

PATCH /tenants/{tenant}/email-configs/{code}/drafts/{messageId}

Saves changes to an existing synced draft via the email provider. The configuration must have ReadEnabled set to true. Every field is the draft's new full content, not an override — omit Attachments to leave the draft's existing attachments untouched. If the response includes ReconnectRequired=true, the OAuth connection needs to be re-authorised.

Parameters

Name	Type	Description
tenant*	path string	The Tenant.Code
The Tenant.Code
code*	path string
messageId*	path string (uuid)

Request Body*

UpdateMailboxDraftRequest

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

Responses

200 OK

DraftOperationResponse

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found