> ## 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.

# New Email

> Start a workflow when a message arrives in an Outlook inbox.

The **New Email** trigger starts a workflow when Microsoft creates a message in
the connected account's Inbox. It can filter by subject and downloads
non-inline attachments for the run.

## Configuration

| Field                 | Type              | Required | Description                                        |
| --------------------- | ----------------- | -------- | -------------------------------------------------- |
| **Microsoft Account** | Microsoft account | Yes      | Outlook Inbox to watch.                            |
| **Subject Filter**    | String            | No       | Required subject text. Matching is case-sensitive. |

Leave **Subject Filter** empty to accept every qualifying new Inbox message.

## Trigger data

| Output              | Type          | Description                                |
| ------------------- | ------------- | ------------------------------------------ |
| **Message ID**      | String        | Microsoft message ID.                      |
| **Conversation ID** | String        | Outlook conversation ID.                   |
| **Sender Name**     | String        | Sender display name, when present.         |
| **Sender Address**  | String        | Sender email address, when present.        |
| **Subject**         | String        | Message subject.                           |
| **Plain Text**      | String        | Message body requested as text.            |
| **HTML**            | String        | Message body requested as HTML.            |
| **Date/Time**       | Date          | Time the message was received.             |
| **Attachments**     | List of files | Downloaded non-inline message attachments. |

<Note>
  Messages sent back to the same account by WorkflowDog are excluded when they
  carry WorkflowDog's automation header. This prevents common self-triggering
  loops.
</Note>

## Example: archive incoming documents

Set **Subject Filter** to `Statement` to limit runs to statement emails. Connect
**Attachments** to a repeat action, then store each file during the loop. The
workflow creates one run per matching email and processes every non-inline
attachment in that message.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The subject filter did not match">
    Matching is case-sensitive and searches for the configured text anywhere in
    the subject.
  </Accordion>

  <Accordion title="An inline image is missing">
    The trigger's attachment list is intended for file attachments and does not
    include inline attachments.
  </Accordion>
</AccordionGroup>
