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

# Outlook

> Connect Outlook to xpander and give agents its 29 actions: how to sign in and connect it, and which actions to hold for approval.

<Badge color="blue">HTTP API connector</Badge>

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to `https://functions.stg.xpander.ai/microsoft-outlook` and carry an OAuth 2.0 token obtained with **Sign in with Microsoft** on the cloud edition, or an API key or custom header on a self-hosted installation, which offers no sign-in flow.

## What the skill can do

API connector: 29 actions, as they appear in the skill panel. 22 of them create, change or delete something in Outlook; mark those under **These actions need approval** when you add the skill to an agent.

* **Calendar events** (8): Update Event By Id, Create New Event, List All Events, List All User Calendars, Get Default Calendar Info, Delete Event By Id, Get Event By Id, List View By Date Range
* **Mail messages** (8): Delete Message By Id, Folders List All Mail Folders, List Messages By Folder Id, Create Draft Message, Get Message By Id, Update Message By Id, Send Draft By Id, Send New Email
* **Mail attachments** (6): Messages List All Messages, Attach Get By Attachment Id, Attach Delete By Attachment Id, Attach List By Message Id, Attach Resolve Content By Id, Attach Create For Message By Id
* **Contact directory** (6): Dir List All Contacts, Dir Delete Contact By Id, Dir Create New Contact, Dir Update Contact By Id, Dir List All Contact Folders, Dir Get Contact By Id
* **Outlook profile** (1): Get Current User Details

## Authentication Options

<Tabs>
  <Tab title="Built-in xpander Auth">
    The simplest way to connect Outlook is by using xpander's built-in authentication:

    1. In Xpander Chat, open the agent's settings and click **Add skill**.
    2. Search for **Outlook** and select it.
    3. Click **+ Create new connection**.
    4. Enter a **connection name**, e.g., "xpander-outlook".
    5. Choose **OAuth2** as the authentication method.
    6. Click **Sign in with Outlook**.
    7. Grant xpander permission to access your account.
    8. Click **Connect**.
  </Tab>
</Tabs>

## Give an agent the Outlook skill

Once Outlook is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **Outlook**. The skill panel lists the Outlook actions by group. Enable only the groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](/use/skills).

## Related Resources

* [Using Services & Skills in the xpander](/use/skills)
* [Outlook Documentation](https://support.microsoft.com/en-us/outlook)