send_conversation
Send Canvas course messages to students. Multi-recipient sends require a preview token before final confirmation.
Instructions
Send messages to students via Canvas conversations.
Sending to ONE recipient is a single call. Sending to MULTIPLE recipients is two-step: call without a confirmation_token to get a preview (recipients, subject, body) plus a token; show that preview to the educator, then call again with the token and identical arguments to actually send. The token expires, is single-use, and is void if any argument changed since the preview.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Message content | |
| mode | No | "sync" or "async" (use async for >100 recipients) | sync |
| subject | Yes | Message subject (max 255 chars) | |
| force_new | No | Force new conversation even if one exists | |
| bulk_message | No | Send individual messages with same subject to each recipient | |
| context_code | No | Course context (e.g., "course_60366") | |
| recipient_ids | Yes | List of Canvas user IDs | |
| attachment_ids | No | Optional attachment IDs | |
| course_identifier | Yes | Course code or Canvas ID | |
| confirmation_token | No | Token from the preview call (multi-recipient only) | |
| group_conversation | No | Create group conversation (required for custom subjects) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||