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

# Outlook

> Turn new mail in Outlook.com or Microsoft 365 into email.received events.

An Outlook source reads new mail in the folders that you pick. It works with Outlook.com, Hotmail and Microsoft 365 mailboxes. Each message becomes an [`email.received`](/events/email-received) event with `"provider": "outlook"`.

<Info>Outlook sources are in beta and need a Pro project.</Info>

## Set up

<Steps>
  <Step title="Connect">
    Open **Sources → Add source → Outlook** and sign in with Microsoft. hooksnode asks for `Mail.Read`, `User.Read` and `offline_access`.
  </Step>

  <Step title="Pick folders">
    Pick one or more folders, for example **Inbox**.
  </Step>

  <Step title="Add filters (optional)">
    Use **From contains**, **To contains** and **Subject contains**. They ignore case.
  </Step>

  <Step title="Turn on bank alerts (optional)">
    See [Bank alerts](/sources/bank-alerts).
  </Step>
</Steps>

## How it works

1. hooksnode subscribes to new messages in each folder through Microsoft Graph.
2. When Graph tells hooksnode about new mail, hooksnode reads it and stores one event for each message. The idempotency key is `outlook:<source>:<message>`.
3. hooksnode renews each subscription before it expires, and checks mailboxes that it has not synced for 10 minutes.

hooksnode starts at the time you connect. It does not send old mail.

## Problems

| What you see                                              | What to do                                                                                                                     |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Your organization needs an admin to approve Hooksnode** | Your Microsoft 365 tenant does not let users give mail access to new apps. Ask your admin to approve hooksnode for the tenant. |
| **Needs sign-in**                                         | The access was revoked, the password changed, or a policy blocked it. Press **Reconnect**.                                     |
| **Some email may have been missed**                       | Microsoft reset the sync. hooksnode started again from now. Mail in the gap is not sent.                                       |