Email - Mailbox
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.
-
GET List ConversationsReturns a paginated list of email conversations (threads). When configCode query param is omitted, searches across mailbox configurations the current .../tenants/{tenant}/mailbox/conversations
-
GET List MessagesReturns a paginated flat list of individual messages (not grouped by thread). When configCode query param is omitted, searches across mailbox configur.../tenants/{tenant}/mailbox/messages
-
POST Send EmailSends a composed email with automatic routing. If configCode is provided, sends via that mailbox. If omitted, uses the tenant's default mailbox. If no.../tenants/{tenant}/mailbox/send
-
GET Get ConversationReturns all messages in a specific conversation thread, ordered by date, enriched with client associations based on participant email addresses matchi.../tenants/{tenant}/email-configs/{code}/conversations/{conversationId}
-
GET Get MessageReturns the full details of a specific message including HTML/plain-text body, recipients (to, cc), and attachment metadata. The body is fetched on-de.../tenants/{tenant}/email-configs/{code}/messages/{messageId}
-
POST Send new emailSends a new email from the tenant's connected mailbox. The configuration must have SendEnabled set to true. The sender (From) is determined by the ema.../tenants/{tenant}/email-configs/{code}/messages
-
PATCH Mark messages as read or unreadUpdates the read/unread status of one or more mailbox messages. The configuration must have ReadEnabled set to true. Provider sync (Microsoft Graph / .../tenants/{tenant}/email-configs/{code}/messages
-
POST Reply to MessageSends a reply to a specific mailbox message via the email provider. The configuration must have SendEnabled set to true. Set ReplyAll to true to reply.../tenants/{tenant}/email-configs/{code}/messages/{messageId}/reply
-
GET Get AttachmentStreams the raw content of a message attachment. Use for downloading files and resolving inline CID images in HTML email bodies. Returns the file with.../tenants/{tenant}/email-configs/{code}/messages/{messageId}/attachments/{attachmentId}
-
POST Link Task to ConversationCreates an association between an email conversation and a task item./tenants/{tenant}/email-configs/{code}/conversations/{conversationId}/tasks
-
DELETE Unlink Task from ConversationRemoves the association between an email conversation and a task item./tenants/{tenant}/email-configs/{code}/conversations/{conversationId}/tasks/{taskCode}
-
POST Trigger Mailbox SyncQueues an immediate sync for this mailbox configuration. Returns 202 Accepted — the sync happens asynchronously. New emails will appear after the sync.../tenants/{tenant}/email-configs/{code}/sync