MailGet

Summary

• Retrieves a single email by id. Ideal for opening a detailed view with subject, sender/recipients, flags, and links.

Graph Endpoint

• GET /me/messages/{id}

Parameters

Required

• id: string — The message ID.

Optional

• select: string[] — Limit the fields you want to receive (e.g., ['id','subject','from','toRecipients','receivedDateTime','isRead','webLink']). If omitted, a sensible default is used.

Usage (app.businessFunction)

Minimal

app.businessFunction({
  functionName: 'MicrosoftGraph',
  methodName: 'Mail',
  operation: 'Get',
  parameters: {
    id: 'AAMkAGI2N...' // message id
  }
})

With select

app.businessFunction({
  functionName: 'MicrosoftGraph',
  methodName: 'Mail',
  operation: 'Get',
  parameters: {
    id: 'AAMkAGI2N...',
    select: [
      'id',
      'subject',
      'from',
      'toRecipients',
      'receivedDateTime',
      'isRead',
      'webLink'
    ]
  }
})

Response

• On success returns the email item under item.

{
  "item": {
    "id": "AAMkAGI2N...",
    "subject": "Quarterly report",
    "from": { "name": "Adele Vance", "address": "[e-mail]" },
    "toRecipients": [
      { "name": "Megan Bowen", "address": "[e-mail]" }
    ],
    "ccRecipients": [],
    "receivedDateTime": "2024-09-23T14:22:17Z",
    "sentDateTime": "2024-09-23T14:21:51Z",
    "isRead": false,
    "hasAttachments": true,
    "importance": "normal",
    "categories": [],
    "webLink": "https://outlook.office.com/mail/id/AAMkAGI2N...",
    "bodyPreview": "Hi team, please find the report attached..."
  }
}

• The exact fields depend on your select parameters. If select is omitted, a sensible default set of fields is returned.