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

# Connect Outlook

> Connect your Microsoft 365 Outlook so your agent can send emails and book appointments in the same place.

Outlook is the only integration in the catalog that solves two things at once: your business **email** and your **calendar**. With a single connection, your agent sends the confirmation by email and puts the appointment on the Microsoft 365 calendar your team already uses.

If your company runs on Microsoft, this is the connection that saves you from wiring up a separate email and a separate calendar.

## What you need first

* A **Microsoft 365** account (work or personal) with mail and calendar.
* The **Starter** plan or higher in Ryvo, with the Engine module active.
* In organizations using Microsoft Entra, an administrator may have to approve the app before the authorization can complete.

## How to connect it

<Steps>
  <Step title="Open Settings › Integrations">
    In the portal, go to **Settings** and then **Integrations**. Find the **Outlook** card.
  </Step>

  <Step title="Click Connect app">
    Microsoft's screen opens in a new window. Meanwhile the card shows **In progress**.
  </Step>

  <Step title="Pick the account and accept">
    Select the Microsoft account your agent should write and book from, and accept the permissions.
  </Step>

  <Step title="Come back to Ryvo">
    You land back on the Integrations screen on your own and the card turns to **Connected**. Outlook asks nothing else.
  </Step>
</Steps>

## What your agent can do once it is connected

| Action                | What it does in the conversation                                                       |
| --------------------- | -------------------------------------------------------------------------------------- |
| **Send email**        | Sends an email from the connected account, to confirm in writing what was agreed.      |
| **Book appointment**  | Creates the appointment on the Outlook calendar once the person confirms day and time. |
| **Check calendar**    | Reads what is booked in a date range, before offering a time.                          |
| **View appointments** | Lists booked appointments, to confirm when the person's is.                            |

Actions are turned on one by one from **View actions** and the [**Tools**](/guides/agents/tools) section of the builder, with a cap of **10 integration actions per agent**.

## What to do if something fails

| What you see                                                  | What happened                                                         | What to do                                                                                |
| ------------------------------------------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| The authorization ends with an organization permissions error | Microsoft Entra requires an administrator to approve third-party apps | Ask your Microsoft 365 administrator to approve the app and click **Connect app** again   |
| The card is stuck on **In progress**                          | You closed the Microsoft window before finishing                      | Click **Check again** and, if nothing changes, connect again                              |
| **The account stopped responding. Connect it again.**         | The password changed, or someone revoked access from Microsoft        | Click **Reconnect**: Ryvo revokes the old access and opens the authorization from scratch |