# Get Selected Email

Gets the currently selected mail messages in Mail. Email messages contain the sender, subject, and message id. They can optionally include the body and raw source of the message. Note that requesting the body and source may significantly lengthen the time the action takes to process.

| Parameters           | Description                                                                                                |
| -------------------- | ---------------------------------------------------------------------------------------------------------- |
| Include Message Body | Specify true to include the message body. This may result in significantly longer times to run the action. |
| Include Raw Source   | Specify true to include the raw source of the message.                                                     |

| Returns       | Description                                                                                                                     |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Email Message | Details of the selected email messages, including sender, subject, and message id. Optionally includes the body and raw source. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.msgfiler.com/shortcuts/get-selected-email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.