Send Message
send_messageSend a new Canvas Inbox message to a professor or classmate, with a subject and body; preview the message first and confirm before final delivery.
Instructions
Send a new Canvas Inbox message, e.g. to a professor or classmate. Recipients get it immediately. Get recipient IDs from find_recipients; to answer an existing thread, use reply_to_conversation. [NEEDS CONFIRMATION: call it once for a preview and a confirm_token, show the preview to the user, and only if they say yes call it again with the same arguments, confirm=true and that confirm_token. Apps that can ask the user directly show a confirmation instead.]
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": {
"recipients": "<recipients>",
"subject": "<subject>",
"body": "<body>"
},
"name": "send_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Message body text. Plain text or simple HTML. | |
| confirm | No | Set to true together with confirm_token to carry out a request you already previewed. | |
| subject | Yes | Message subject line. | |
| course_id | No | Course context, recommended | |
| recipients | Yes | Canvas user IDs from find_recipients | |
| confirm_token | No | The one-time token from the preview. Only use it after the user has said yes. | |
| separate_threads | No | Send individually rather than as a group thread |