/v1/message-draftsWrite a draft for somebody to look over
Writes the words of an email or text and queues them for approval instead of sending them: write a draft here when a person should look over the wording before it goes out. When asked to draft an email, use this tool so the email appears in the person's Inbox → Drafts, and tell them where it is saved. Body: recipient (required), body (required), channel (email or sms), subject (email only), optional templateId, and definitionKey plus rowId (both or neither) to preserve the related record. Do not replace saving with a chat-only answer. An email's sender can be chosen in the draft editor later, or remembered with a versioned patch after creating it. A draft request never authorizes sending. Once explicitly asked to send a saved email, use post_message-drafts_id_send with its current updatedAt as expectedUpdatedAt, recipient, subject, body and authorized accountIdentifier. Approval alone sends nothing.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"aiFlaggedFigures": [
"string"
],
"aiGenerated": true,
"aiIntent": "string",
"aiModel": "string",
"aiPromptHash": "string",
"approvedAt": "2026-01-01T00:00:00Z",
"approvedByUserId": 1,
"body": "string",
"cancellationReason": "string",
"cancelledAt": "2026-01-01T00:00:00Z",
"channel": "string",
"createdAt": "2026-01-01T00:00:00Z",
"createdByKind": "string",
"createdByUserId": 1,
"detail": {},
"entityId": 1,
"entityKind": "string",
"id": 1,
"recipient": "string",
"recordDefinitionKey": "string",
"recordRowId": "",
"ruleId": 1,
"status": "string",
"subject": "string",
"templateId": 1,
"updatedAt": "2026-01-01T00:00:00Z"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}