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

# Microsoft Teams

> Connect Microsoft Teams to xpander and give agents its 38 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://graph.microsoft.com/v1.0` 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: 38 actions, as they appear in the skill panel. 23 of them create, change or delete something in Microsoft Teams; mark those under **These actions need approval** when you add the skill to an agent.

* **Message service** (20): Chat Manage Get Chat By Chat Id, Chat Manage Get List Of User Chats, Chat Message Get List By Chat Id, Chat Message Delete Message By Chat Id Message Id, Chat Message Create Message By Chat Id, Chat Message Get Message By Chat Id Message Id, Chat Message Update Message By Chat Id Message Id, Channel Message Get List By Group Channel, Channel Message Create Message By Group Channel, Channel Manage Get List By Group Team Id, Channel Message Get Message By Group Channel Message Id, Channel Message Update Message By Group Channel Message Id, Channel Membership Get List By Joined Team Id, Channel Message Delete Message By Group Channel Message Id, and 6 more
* **Channel management** (8): Manage Create Channel By Group Team Id, Manage Get Channel By Group Team Channel Id, Membership Create Channel By Joined Team Id, Membership Get Channel By Joined Team Channel Id, Manage Delete Channel By Group Team Channel Id, Manage Update Channel By Group Team Channel Id, Membership Delete Channel By Joined Team Channel Id, Membership Update Channel By Joined Team Channel Id
* **Team management** (7): Manage Get Team By Group Id, Manage Delete Team By Group Id, Manage Create Team By Group Id, Membership Get Joined Team By Team Id, Membership Delete Joined Team By Team Id, Membership Update Joined Team By Team Id, Membership Create Joined Team Reference
* **Chat management** (3): Manage Create New Chat Object, Manage Delete Chat By Chat Id, Manage Update Chat By Chat Id

## Authentication Options

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

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

## Give an agent the Microsoft Teams skill

Once Microsoft Teams is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **Microsoft Teams**. The skill panel lists the Microsoft Teams 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)
* [Microsoft Teams Documentation](https://learn.microsoft.com/en-us/microsoftteams/)
