Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-25173140700.7 KB
ToolAction

Send an email from a draft

Send an email from a user-approved, tool-generated draft via Microsoft Graph.

post/tool-actions/email/send

Query parameters

cookie_namestring nullable

Request body

tool_call_idstring required

The ID of the tool call that generated the draft

subjectstring required

Email subject

bodystring required

Email body content (can be markdown or HTML)

Example request

{
  "tool_call_id": "call_abc123",
  "subject": "Q2 report",
  "body": "Hi team,\n\nPlease find the **Q2 report** attached."
}

Response

Successful Response

successboolean required

Whether the email was sent successfully.

messagestring required

Human-readable result message.

recipientsstring[] nullable

The recipients the email was sent to, if available.

Example response

{
  "success": true,
  "message": "Email sent successfully",
  "recipients": [
    "alice@example.com"
  ]
}