# Microsoft Teams integration account

> How to set up, check and repair the Microsoft Teams integration account that Conclude posts as when a user has no credentials in the tenant.

Canonical HTML page: https://conclude.io/doc/admin/organization/integration-account/
Last updated: 2026-11-02

---

This page is for Microsoft 365 and Conclude admins who run Connect on Microsoft Teams.

**We strongly recommend an integration account when you use Microsoft Teams.** Set one up on every Teams tenant that uses Connect. Without it, Conclude posts some messages through the Conclude bot, which can't post files and can break mentions, or with another channel member's credentials.

## Setting up an integration account for Microsoft Teams

An integration account lets Conclude post messages to Teams channels and chats when the author of the message has no credentials in the tenant. You can set it up during onboarding, or follow the steps below.

**The integration account needs a Microsoft 365 license that includes Teams.** These accounts are not enough:

* Teams (free) does not work with enterprise apps
* Azure AD or Entra ID alone cannot use Teams
* A shared mailbox or service account without a full license cannot post

[Read more about how to assign Teams add-on licenses to users](https://learn.microsoft.com/en-us/microsoftteams/teams-add-on-licensing/assign-teams-add-on-licenses).

[Video](https://www.youtube.com/watch?v=YO3lKUi_Yfs)

## How it works

* A Microsoft 365 admin creates a generic user account that belongs to no person, for example "Conclude integration". Conclude posts under this identity when no user credentials are available
* In the Conclude Admin console, an admin selects the user account and signs it in
* Once the account is set up, Conclude posts as it whenever it cannot post as the author of the message. Without the account, Conclude falls back to the Conclude bot, which cannot post file attachments. It then falls back to another channel member's credentials. A message posted with a member's credentials carries a fallback notice, and admins get a system alert

## Setting up an integration account

1. Open [**Admin console > Organization > Integration account**](https://conclude.io/admin/integration-account). Only admins can open the Admin console. You find it at the bottom of the sidebar.
2. Select the integration account you created from the drop-down, then select **Save**. To run a workspace without one, select **Integration account not needed**. The Admin console then stops flagging the workspace.
3. Until the account has signed in to Conclude, the page shows **Not signed in**. Select **Authorize with Microsoft** and sign in as the integration account to authorize Conclude.

![Integration account page in the Admin console with the account drop-down and Save button](https://conclude.io/images/doc/integration-account-teams-graph1.webp)

4. Select **Run diagnostics**. The diagnostics check that the account exists in the directory and is signed in to Conclude. They also check that it has Microsoft Graph access and a Teams license. Finally, they check that it is a member of every team and connected channel or chat that needs it. If the integration account is missing from connected channels or chats, the diagnostics show how many are affected and list them below the warning. Channels and chats you are not a member of are listed without a name.

![Run diagnostics result showing a warning and the list of affected connected channels and chats](https://conclude.io/images/doc/integration-account-teams-graph2.webp)

5. If the integration account is missing from connected channels or chats, select **Repair**. Conclude adds the account to each listed channel and chat, one at a time. It uses the credentials of a channel member who is signed in to Conclude. Each row is then marked **Added** or **Failed**. Repair cannot add the account to a team. It also cannot add the account to a shared channel hosted by another Microsoft 365 tenant. In those cases an owner adds it in Microsoft Teams instead.

![Repair action on an affected channel, with a repaired channel marked as Added](https://conclude.io/images/doc/integration-account-teams-graph3.webp)

You set one integration account per Microsoft 365 tenant, which is one Teams workspace in Conclude. It applies to every connected channel and chat in that tenant.

## Additional tips

* Add the integration account to every team that contains connected channels. Conclude cannot add team members itself. For a private channel, add the account by hand or use **Repair**
* Set up the account even when users exist on both sides. It is the fallback when credentials are not available for every user

## Related pages

* [Internal](https://conclude.io/doc/connect/internal/), [External](https://conclude.io/doc/connect/external/) and [Bridge](https://conclude.io/doc/connect/bridge/) connections are where the integration account is needed
* [Troubleshooting](https://conclude.io/doc/connect/troubleshooting/) helps when messages come from a fallback sender or do not sync
* The [Connect External quickstart](https://conclude.io/quickstart/connect-external/) walks through the guided setup