graph_forward_mail
Forward an Outlook email to one or more recipients, with an optional note, and optionally save it as an unsent draft in your or a shared mailbox.
Instructions
Forward an email to other recipients.
Args:
message_id: The email message ID to forward.
to: List of recipient email addresses.
comment: Optional note to add above the forwarded message. When
is_html is true, send explicit HTML; markdown is not converted.
is_html: Whether the comment is HTML content (default: True). Use
false for plain text.
as_draft: Whether to leave the forward as an unsent draft (default false).
Returns the created draft instead of a sent status.
mailbox: Shared mailbox address or user ID to act on. Empty targets your own
mailbox. Requires the delegated Mail.*.Shared permissions.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"message_id": "<message_id>",
"to": "<to>"
},
"name": "graph_forward_mail"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ||
| comment | No | ||
| is_html | No | ||
| mailbox | No | ||
| as_draft | No | ||
| message_id | Yes |