> ## Documentation Index
> Fetch the complete documentation index at: https://learn.workflow.dog/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Conversation

> Load every message in an Outlook conversation from oldest to newest.

The **Get Conversation** action retrieves every mailbox message with a matching
Outlook conversation ID. It follows Microsoft pagination, sorts messages by
received time, and returns the complete conversation oldest first.

## Inputs

| Input                    | Type              | Required | Description                                                |
| ------------------------ | ----------------- | -------- | ---------------------------------------------------------- |
| **Third-party account**  | Microsoft account | Yes      | Account whose mailbox is searched.                         |
| **Conversation ID**      | String            | Yes      | Outlook conversation ID from a trigger, draft, or message. |
| **Download Attachments** | Boolean           | No       | Download files for every message. Defaults to `false`.     |

<Tip>
  Leave attachment downloading off when you only need conversation text. It adds
  a request for each message that reports attachments.
</Tip>

## Outputs

**Messages** is a list ordered from oldest to newest. Each item includes:

| Field               | Type          | Description                                 |
| ------------------- | ------------- | ------------------------------------------- |
| **Message ID**      | String        | Microsoft message ID.                       |
| **Conversation ID** | String        | Conversation ID returned by Microsoft.      |
| **Sender Name**     | String        | Sender display name.                        |
| **Sender Address**  | String        | Sender email address.                       |
| **Subject**         | String        | Message subject.                            |
| **Plain Text**      | String        | Body requested as text.                     |
| **HTML**            | String        | Body requested as HTML.                     |
| **Date/Time**       | Date          | Received time.                              |
| **Is Read**         | Boolean       | Outlook read state.                         |
| **Attachments**     | List of files | Available only when downloading is enabled. |

<Warning>
  Toggling **Download Attachments** changes the nested output shape by adding or
  removing **Attachments**. Check downstream connections after changing it.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="No messages are returned">
    Trimmed Conversation ID matching is exact. Confirm the ID comes from the
    same Microsoft mailbox and has not been confused with a Message ID.
  </Accordion>
</AccordionGroup>