create-forward-draft
Create a draft to forward an email message for review before sending. Supports JSON or MIME formats and allows editing recipients and content.
Instructions
Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:
Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.
Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.
Update the draft later to add content to the body or change other message properties. When using MIME format:
Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.
Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation.
š” TIP: Create a forward draft (does not send). Useful when user wants to review before sending.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | ||
| messageId | Yes | Path parameter: messageId | |
| includeHeaders | No | Include response headers (including ETag) in the response metadata | |
| excludeResponse | No | Exclude the full response body and only return success or failure indication |