> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/guides-and-quickstarts/using-tools-and-actions/microsoft-teams-connector-and-tool-setup.md).

# Microsoft Teams connector and tool setup

The Microsoft Teams connector gives workflows access to Teams operations through Microsoft authorization. The authentication method must match the selected action.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FnK05YYD2rCQWG4lyLMDL%2FG049B.mp4?alt=media&token=a10e6bcb-4b3f-49f9-aefa-ad628fc03144>" %}

## Before you start

Have permission to configure the Microsoft Entra application. Identify the permissions and connection type required by the Teams action.

## Choose delegated authentication

Choose delegated OAuth when the action operates on behalf of a signed-in Microsoft user.

![Microsoft delegated authentication option](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/VHCpq5Q2f0qw2CME5CX2/assets/g049b-g049b-01-delegated.png)

Check the action's connection requirements before choosing a method.

## Configure the Entra application

In Microsoft Entra, configure the application's supported account types and web redirect.

![Microsoft Entra application configuration](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/5gaBSgcBfhmC6ylBMXw2/assets/g049b-g049b-02-registration.png)

Copy the callback directly from StackAI to avoid a redirect mismatch.

Add the delegated API permissions required by the intended action.

![Microsoft Entra application configuration](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/HSVJHFpT3TlPhmofJATS/assets/g049b-g049b-03-permissions.png)

Your tenant's policy may require an administrator to grant consent.

Enter the required tenant details, client ID, and secret in the connector.

![Microsoft Entra application configuration](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/CDyuFwIaMeHwwIORsrtr/assets/g049b-g049b-04-credentials.png)

Use the values from the corresponding registered application.

## Authorize the Microsoft account

Create the delegated connection and authorize the intended Microsoft account.

![Microsoft account authorization flow](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/lm4gO40JqpWSdPA1NVQ6/assets/g049b-g049b-05-authorize.png)

Check its health after the authorization flow returns to StackAI.

## Run an action with delegated access

Add List Teams and select the delegated connection.

![Delegated Teams action results](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/iqyMBc69XfCBAkTynpyO/assets/g049b-g049b-06-list.png)

Review the connection-type hint because some Teams actions require a particular authentication method.

Run List Teams and inspect the returned teams array.

![Delegated Teams action results](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/llgvJ9n7DuJTxRa0GuWA/assets/g049b-g049b-07-list-result.png)

Confirm that the account can access the teams needed by the workflow.

## Configure application access when required

Use an app-only connection only for actions that support application credentials.

![Microsoft application access configuration](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/8UBxnekVEstUtIgFMT8N/assets/g049b-g049b-08-app-only.png)

Its tenant and application permissions differ from a delegated user grant.

For Get Meeting Transcripts, supply the required organizer and meeting identifiers with a supported connection.

![Microsoft application access configuration](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/9zlICR7JGKbumJEixeLz/assets/g049b-g049b-09-transcripts.png)

Inspect an actual response before relying on the configuration.

## Important behavior

Delegated access acts on behalf of a signed-in user. App-only access uses the application’s permissions. Choose the connection type supported by the action.

Tenant policy can require administrator consent for requested permissions.

## Continue

* [Configure and test an action](https://docs.stackai.com/guides-and-quickstarts/using-tools-and-actions/configure-and-test-an-action.md)
* [Custom OAuth scopes and reauthorization](https://docs.stackai.com/guides-and-quickstarts/using-tools-and-actions/custom-oauth-scopes-and-reauthorization.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/guides-and-quickstarts/using-tools-and-actions/microsoft-teams-connector-and-tool-setup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
