API Docs / Schemas / SendMailboxEmailRequest

SendMailboxEmailRequest

Request DTO for sending a new email from a tenant's connected mailbox.

Properties

Name Type Description
subjectstring

Email subject line (optional; defaults to an empty subject when omitted)

Email subject line (optional; defaults to an empty subject when omitted)

htmlBodystring

HTML body of the email

HTML body of the email

plainTextBodystring

Plain text body of the email (used as fallback when HTML is not supported)

Plain text body of the email (used as fallback when HTML is not supported)

to*array of EmailRecipientDto

List of To recipients (at least one required)

List of To recipients (at least one required)

ccarray of EmailRecipientDto

List of CC recipients (optional)

List of CC recipients (optional)

bccarray of EmailRecipientDto

List of BCC recipients (optional)

List of BCC recipients (optional)

attachmentsarray of EmailAttachmentDto

List of attachments as base64-encoded content (optional)

List of attachments as base64-encoded content (optional)

addHeaderFooterboolean

Whether to wrap the body with the tenant's configured header/footer before sending. Defaults to false when omitted.

Whether to wrap the body with the tenant's configured header/footer before sending. Defaults to false when omitted.

practiceDocumentCodesarray of string

Codes of practice documents (tenant document library) to attach. Resolved to file
content server-side, so the browser never round-trips the document bytes.

Codes of practice documents (tenant document library) to attach. Resolved to file
content server-side, so the browser never round-trips the document bytes.

scheduledAtstring

When set, the email is not sent now: a scheduled send is created and dispatched at this
UTC instant. Must be in the future. Omit to send immediately.

When set, the email is not sent now: a scheduled send is created and dispatched at this
UTC instant. Must be in the future. Omit to send immediately.

JSON Example

{
  "subject": "string",
  "htmlBody": "string",
  "plainTextBody": "string",
  "to": [
    {
      "email": "...",
      "name": "..."
    }
  ],
  "cc": [
    {
      "email": "...",
      "name": "..."
    }
  ]
}

Used By Operations

Contained in Schemas