Profile for sending email via the Microsoft Graph /sendMail endpoint. Pins target.system to ms_graph, bounds attachment size, and adds Outlook-specific importance and delivery options.
Implements: Send email message (org.intentschema.communication.email.message.send.v1)
| Field | Type | Description |
|---|---|---|
target * | Target | (system = "ms_graph", required: system) |
object * | object | |
idempotency_key | string | |
ms_graph @com.microsoft.graph | object |
object| Field | Type | Description |
|---|---|---|
from | string (email)[] | |
to * | string (email)[] (minItems 1) | |
cc | string (email)[] | |
bcc | string (email)[] | |
subject * | string | |
textBody | string | |
htmlBody | string | |
attachments | BlobRef[] |
ms_graph @com.microsoft.graph| Field | Type | Description |
|---|---|---|
conversationId | string | Graph conversation id; set when this send belongs to an existing conversation. |
importance | enum: low | normal | high | |
requestDeliveryReceipt | boolean | |
requestReadReceipt | boolean | |
categories | string[] |
| Field | Type | Description |
|---|---|---|
external_id * | string | Provider message id. |
thread_id | string | |
sent_at * | string (date-time) |
| Field | Value |
|---|---|
base_url | https://graph.microsoft.com |
method | POST |
path | /v1.0/me/sendMail |
scopes | Mail.Send |
docs | https://learn.microsoft.com/en-us/graph/api/user-sendmail |
| Intent field | API parameter |
|---|---|
object.to | message.toRecipients[].emailAddress.address |
object.cc | message.ccRecipients[].emailAddress.address |
object.bcc | message.bccRecipients[].emailAddress.address |
object.from | message.from.emailAddress.address |
object.subject | message.subject |
object.textBody | message.body.content (contentType: text) |
object.htmlBody | message.body.content (contentType: html) |
object.attachments | message.attachments[] (base64 or reference) |
idempotency_key | Prefer: IdType='ImmutableId' header or client-supplied internetMessageId |
ms_graph.conversationId | message.conversationId |
ms_graph.importance | message.importance |
ms_graph.requestDeliveryReceipt | message.isDeliveryReceiptRequested |
ms_graph.requestReadReceipt | message.isReadReceiptRequested |
ms_graph.categories | message.categories[] |