# 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

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

#### With select

```js
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`.

```json
{
  "item": {
    "id": "AAMkAGI2N...",
    "subject": "Quarterly report",
    "from": { "name": "Adele Vance", "address": "adelev@contoso.com" },
    "toRecipients": [
      { "name": "Megan Bowen", "address": "meganb@contoso.com" }
    ],
    "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.
