MailForward

Summary

• Forwards a message to specified recipients, with an optional comment.

Graph Endpoint

• POST /me/messages/{id}/forward

Parameters

Required

• messageId: string — The original message id (alias: id).

• to: string[] — Recipient email addresses.

Optional

• comment: string

• attachmentIds: number[] — Up to 10 repository attachment IDs. If provided, the system creates a draft forward, uploads the files, then sends it.

Usage (app.businessFunction)

Minimal

app.businessFunction({
  functionName: 'MicrosoftGraph',
  methodName: 'Mail',
  operation: 'Forward',
  parameters: {
    messageId: 'AAMkAGI2N...',
    to: ['[e-mail]']
  }
})

With comment

app.businessFunction({
  functionName: 'MicrosoftGraph',
  methodName: 'Mail',
  operation: 'Forward',
  parameters: {
    id: 'AAMkAGI2N...',
    to: ['[e-mail]'],
    comment: 'FYI'
  }
})

With attachments

app.businessFunction({
  functionName: 'MicrosoftGraph',
  methodName: 'Mail',
  operation: 'Forward',
  parameters: {
    messageId: 'AAMkAGI2N...',
    to: ['[e-mail]'],
    attachmentIds: [1012, 1013] // up to 10
  }
})

Response

{ "ok": true }

Notes

• The attachmentIds must point to repository attachments with accessible file data. If external storage is configured and a blob was deleted, re-upload the file or update the attachment.