> Index of every Falcon docs page, for assistants: https://falcon.com/docs/llms.txt

# Outlook

Read and send the signed-in person's Outlook mail, read and change their calendars, and start a workflow when mail or an event changes.

## What it can do

- Read mail: **List messages**, **Search messages**, **Get message**, **List mail folders**, **List folder messages** and **List attachments**.
- Change mail: **Move message**, **Update message**, **Create draft**, **Create change subscription**, **Renew change subscription** and **Delete change subscription**.
- Leave the company: **Send message**, **Reply to message**, **Forward message**, **Send draft**, **Create event**, **Update event** and **Delete event**.
- Read the calendar: **List calendars**, **List events**, **List calendar view** and **Get event**.

This app opens only the signed-in person. It does not open another person's mailbox. **List attachments** returns names and sizes, not the file bytes. A send that is accepted is not the same as a message that arrived. **Delete event** can send a cancellation. One list is at most 50 rows, not the whole mailbox.

## What can start a workflow

- **Message created**, **Message updated**, **Message deleted**, **Event created**, **Event updated**, **Event deleted** and **Subscription lifecycle**.
- The notice names the record. **Get message** or **Get event** reads it. The notice does not include the message body.
- A subscription lasts under 7 days. Renew it before it ends. A lifecycle notice means renew it, create it again, or list recent messages or events. It is not a full history of what was missed.

## How to connect

Open **Connections**, then **Apps**. In the **Apps** heading, search with **Search apps to add** and choose **Add** on Outlook.

When the panel offers **Who signs in**, pick **Sign in as the company (one account for every agent)** or **Each person signs in to their own account when first needed**.

Read what it asks for. If it has not said, the panel says **You'll see what Outlook asks for on its own sign-in page.** Choose **Continue to Outlook** and finish there. Do not paste a password into Studio. When it works, the row says **Connected**.

If it says **This app can't be connected here yet: it needs a sign-in setup this server doesn't have.** or **Connecting Outlook opens soon on this server.**, this server cannot sign Outlook in yet. If you do not see **Add**, ask an admin to add Outlook.

## What it asks for

- Stay signed in (`offline_access`).
- Read and change the signed-in person's mail (`Mail.ReadWrite`). It does not send mail.
- Send, reply, forward and send a draft (`Mail.Send`).
- Read and change the signed-in person's calendars (`Calendars.ReadWrite`).
- It does not ask for access to a shared mailbox, and it does not ask for an app-wide permission.

## Related

- [Gmail](https://falcon.com/docs/app-gmail)
- [Google Calendar](https://falcon.com/docs/app-google-calendar)
- [Connections](https://falcon.com/docs/connections)