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

# Microsoft Teams

> How to set up the Microsoft Teams connector, plus the actions and events that are available.

![Microsoft Teams](https://stackone-logos.com/api/teams/filled/svg)

v3.0.0[See changelog](https://docs.stackone.com/connectors/microsoftteams/changelog.md)

[72 actions](#actions) · [6 events](#events) · 3 auth methods

IAM
Messaging

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/microsoftteams/guides/connector-profile/oauth-2-0.md)
>
> Delegated access on behalf of a signed-in user. Required for actions on chats, user profiles, and /me endpoints.

> [card] [OAuth 2.0 (Client Credentials) · Connector Profile](https://docs.stackone.com/connectors/microsoftteams/guides/connector-profile/oauth-2-0-client-credentials.md)
>
> App-only access without a signed-in user. Best for background services and automation. Cannot access user-specific endpo...

> [card] [OAuth 2.0 (with Bot Framework) · Connector Profile](https://docs.stackone.com/connectors/microsoftteams/guides/connector-profile/oauth-2-0-with-bot-framework.md)
>
> Delegated access with bot messaging capabilities. Uses a single app registration for both Graph API and Bot Framework. T...

Optionally, configure receiving Events for Microsoft Teams into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/microsoftteams/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/microsoftteams/guides/link-account/oauth-2-0.md)

> [card] [OAuth 2.0 (Client Credentials) · Link Account](https://docs.stackone.com/connectors/microsoftteams/guides/link-account/oauth-2-0-client-credentials.md)

> [card] [OAuth 2.0 (with Bot Framework) · Link Account](https://docs.stackone.com/connectors/microsoftteams/guides/link-account/oauth-2-0-with-bot-framework.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

OAuth 2.0

OAuth 2.0 (Client Credentials)

OAuth 2.0 (with Bot Framework)

No auth methods found

Scopes

Select all
|
Clear

Channel.Create

Channel.Delete.All

Channel.ReadBasic.All

ChannelMember.Read.All

ChannelMember.ReadWrite.All

ChannelMessage.Read.All

ChannelMessage.ReadWrite

ChannelMessage.Send

ChannelSettings.ReadWrite.All

Chat.Create

Chat.ManageDeletion.All

Chat.Read

Chat.ReadBasic

Chat.ReadWrite

ChatMember.ReadWrite

ChatMessage.Send

Files.Read.All

Group.ReadWrite.All

Subscription.Read.All

Team.Create

Team.ReadBasic.All

TeamMember.Read.All

TeamMember.ReadWrite.All

TeamMember.ReadWriteNonOwnerRole.All

TeamSettings.ReadWrite.All

TeamsAppInstallation.ReadWriteSelfForUser

TeamsTab.Read.All

TeamsTab.ReadWriteSelfForTeam

User-PasswordProfile.ReadWrite.All

User.Read

User.ReadBasic.All

User.ReadWrite.All

No scopes found

72 actions

ActionDescriptionRequired scopes

List Users`microsoftteams_list_users`

Retrieve a list of user objects. By default, returns a limited set of properties (businessPhones, displayName, givenName...

`User.ReadBasic.All`

Get User`microsoftteams_get_user`

Retrieve the properties and relationships of a specific user by their ID or userPrincipalName. By default, only a limite...

`User.Read`

Create User`microsoftteams_create_user`

Create a new user account in the organization with the specified properties

`User.ReadWrite.All`

Delete User`microsoftteams_delete_user`

Delete a specific user from the organization by their ID or userPrincipalName

`User.ReadWrite.All`

Change Password`microsoftteams_change_password`

Change the password for the authenticated user. The user must provide their current password and the new password.

`User-PasswordProfile.ReadWrite.All`

Get Current User`microsoftteams_get_current_user`

Retrieve the properties and relationships of the currently authenticated user

`User.Read`

List Teams`microsoftteams_list_teams`

Retrieve a list of all teams in an organization using the direct teams endpoint

`Team.ReadBasic.All`

Create Team`microsoftteams_create_team`

Create a new team from a template or from an existing group

`Team.Create`

Get Team`microsoftteams_get_team`

Retrieve the properties and relationships of a specific team by its ID

`Team.ReadBasic.All`

Update Team`microsoftteams_update_team`

Update the properties of the specified team

`TeamSettings.ReadWrite.All`

Delete Team`microsoftteams_delete_team`

Delete a team and move it to the recycle bin for 30 days

`Group.ReadWrite.All`

Archive Team`microsoftteams_archive_team`

Archive a team to prevent most changes while maintaining membership

`TeamSettings.ReadWrite.All`

Unarchive Team`microsoftteams_unarchive_team`

Restore an archived team to active state

`TeamSettings.ReadWrite.All`

Add Team Member`microsoftteams_add_team_member`

Add a member to a team

`TeamMember.ReadWrite.All`

Add Team Members In Bulk`microsoftteams_add_team_members_bulk`

Add multiple members to a team in a single request

`TeamMember.ReadWriteNonOwnerRole.All`

Remove Team Member`microsoftteams_remove_team_member`

Remove a member from a team

`TeamMember.ReadWriteNonOwnerRole.All`

Remove Team Members In Bulk`microsoftteams_remove_team_members_bulk`

Remove multiple members from a team in a single request

`TeamMember.ReadWrite.All`

List Team Members`microsoftteams_list_team_members`

Get the conversationMember collection of a team

`TeamMember.Read.All`

Get Team Member`microsoftteams_get_team_member`

Get a conversationMember from a team

`TeamMember.Read.All`

Clone Team`microsoftteams_clone_team`

Create a copy of a team with specified parts

`Team.Create`

List Channels`microsoftteams_list_channels`

Retrieve the list of channels owned by a team (excludes incoming shared channels). Use list\_all\_channels to also include...

`Channel.ReadBasic.All`

Get Channel`microsoftteams_get_channel`

Retrieve the properties and relationships of a channel

`Channel.ReadBasic.All`

List All Channels`microsoftteams_list_all_channels`

Get all channels in a team including incoming shared channels from other teams. Use list\_channels if you only need chann...

`Channel.ReadBasic.All`

List Incoming Channels`microsoftteams_list_incoming_channels`

Get the list of incoming channels (channels shared with a team)

`Channel.ReadBasic.All`

Get Primary Channel`microsoftteams_get_primary_channel`

Get the default channel, General, of a team

`Channel.ReadBasic.All`

Create Channel`microsoftteams_create_channel`

Create a new channel in a team, as specified in the request body

`Channel.Create`

Update Channel`microsoftteams_update_channel`

Update the properties of the specified channel

`ChannelSettings.ReadWrite.All`

Delete Channel`microsoftteams_delete_channel`

Delete a specific channel from a team. Deleting a channel is a permanent operation that cannot be undone.

`Channel.Delete.All`

List Channel Tabs`microsoftteams_list_channel_tabs`

Retrieve the list of tabs in the specified channel within a team

`TeamsTab.Read.All`

Get Channel Files Folder`microsoftteams_get_channel_files_folder`

Get the metadata for the location where the files of a channel are stored

`Files.Read.All`

List Channel Members`microsoftteams_list_channel_members`

Get a list of members in a channel, including direct members of standard, private, and shared channels

`ChannelMember.Read.All`

List All Channel Members`microsoftteams_list_all_channel_members`

Get a list of all members in a channel, including direct and indirect members

`ChannelMember.Read.All`

Get Channel Member`microsoftteams_get_channel_member`

Get a conversationMember from a channel

`ChannelMember.Read.All`

Archive Channel`microsoftteams_archive_channel`

Archive a channel in a team

`ChannelSettings.ReadWrite.All`

Unarchive Channel`microsoftteams_unarchive_channel`

Restore an archived channel in a team

`ChannelSettings.ReadWrite.All`

Add Channel Member`microsoftteams_add_channel_member`

Add a conversationMember to a channel

`ChannelMember.ReadWrite.All`

Remove Channel Member`microsoftteams_remove_channel_member`

Delete a conversationMember from a channel

`ChannelMember.ReadWrite.All`

Get Channel Tab`microsoftteams_get_channel_tab`

Retrieve the properties and relationships of a specified tab in a channel within a team

`TeamsTab.Read.All`

Delete Channel Tab`microsoftteams_delete_channel_tab`

Remove (unpin) a tab from the specified channel within a team

`TeamsTab.ReadWriteSelfForTeam`

List Channel Messages`microsoftteams_list_channel_messages`

Retrieve the list of messages (without the replies) in a channel of a team

`ChannelMessage.Read.All`

List All Channel Messages`microsoftteams_list_all_channel_messages`

Retrieve messages across all channels in a team, including text, audio, and video conversations

`ChannelMessage.Read.All`

Get Channel Message`microsoftteams_get_channel_message`

Retrieve a single message or a message reply in a channel

`ChannelMessage.Read.All`

Send Channel Message`microsoftteams_send_channel_message`

Send a new message to a specific channel. Only the body property is mandatory.

`ChannelMessage.Send`

Update Channel Message`microsoftteams_update_channel_message`

Update an existing message in a channel using delegated permissions

`ChannelMessage.ReadWrite`

Delete Channel Message`microsoftteams_soft_delete_channel_message`

Soft-delete a message in a channel

`ChannelMessage.ReadWrite`

List Message Replies`microsoftteams_list_channel_message_replies`

Retrieve all replies to a specific message in a channel. Supports $top and $expand OData query parameters.

`ChannelMessage.Read.All`

Send Message Reply`microsoftteams_send_message_reply`

Send a reply to a specific message in a channel. Only the body property is mandatory.

`ChannelMessage.Send`

Get Message Reply`microsoftteams_get_channel_message_reply`

Retrieve a specific reply to a message in a channel

`ChannelMessage.Read.All`

List Chat Messages`microsoftteams_list_chat_messages`

Retrieve all messages in a specific chat. Supports $top (max 50), $orderby (lastModifiedDateTime or createdDateTime in d...

`Chat.Read`

Get Chat Message`microsoftteams_get_chat_message`

Retrieve a specific message in a chat by its ID

`Chat.Read`

Send Chat Message`microsoftteams_send_chat_message`

Send a new message to a specific chat. Only the body property is mandatory.

`ChatMessage.Send`

Delete Chat Message`microsoftteams_soft_delete_chat_message`

Soft-delete a message in a chat

`Chat.ReadWrite`

Undo Soft Delete Chat Message`microsoftteams_undo_soft_delete_chat_message`

Undo soft deletion of a single chat message or a message reply in a channel or a chat

`Chat.ReadWrite`

List Chats`microsoftteams_list_chats`

Retrieve all chats that the authenticated user is a participant in. Supports $expand, $top, $filter, and $orderby query...

`Chat.ReadBasic`

Get Chat`microsoftteams_get_chat`

Retrieve the properties and relationships of a specific chat

`Chat.ReadBasic`

Create Chat`microsoftteams_create_chat`

Create a new chat with specified members. Supports one-on-one and group chats. Only one one-on-one chat can exist betwee...

`Chat.Create`

Update Chat`microsoftteams_update_chat`

Update the properties of a chat object. This can only be used to set the topic for a chat with a chatType value of group...

`Chat.ReadWrite`

Delete Chat`microsoftteams_delete_chat`

Delete a chat object. This operation is permanent and cannot be undone.

`Chat.ManageDeletion.All`

List Chat Members`microsoftteams_list_chat_members`

Retrieve all members in a specific chat. This operation does not support OData query parameters to customize the respons...

`Chat.ReadBasic`

Add Chat Member`microsoftteams_add_chat_member`

Add a conversationMember to a chat

`ChatMember.ReadWrite`

Remove Chat Member`microsoftteams_remove_chat_member`

Remove a conversationMember from a chat.

`ChatMember.ReadWrite`

Get Chat Member`microsoftteams_get_chat_member`

Retrieve a single conversationMember from a chat.

`Chat.ReadBasic`

List Subscriptions`microsoftteams_list_subscriptions`

List all active Graph webhook subscriptions

`Subscription.Read.All`

Get Subscription`microsoftteams_get_subscription`

Get a subscription by ID

`Subscription.Read.All`

Bot Create Conversation`microsoftteams_bot_create_conversation`

Creates a new conversation between the bot and one or more users

`TeamsAppInstallation.ReadWriteSelfForUser`

Bot Send To Conversation`microsoftteams_bot_send_to_conversation`

Sends an activity (message) to a Bot Framework conversation

`TeamsAppInstallation.ReadWriteSelfForUser`

Bot Reply To Activity`microsoftteams_bot_reply_to_activity`

Sends a reply to a specific activity in a Bot Framework conversation

`TeamsAppInstallation.ReadWriteSelfForUser`

Bot Update Activity`microsoftteams_bot_update_activity`

Updates an existing activity in a Bot Framework conversation

`TeamsAppInstallation.ReadWriteSelfForUser`

Bot Delete Activity`microsoftteams_bot_delete_activity`

Deletes an existing activity from a Bot Framework conversation

`TeamsAppInstallation.ReadWriteSelfForUser`

Bot Get Conversation Members`microsoftteams_bot_get_conversation_members`

Gets all members of a Bot Framework conversation in a single response (no pagination)

`TeamsAppInstallation.ReadWriteSelfForUser`

Bot Get Conversation Paged Members`microsoftteams_bot_get_conversation_paged_members`

Gets members of a Bot Framework conversation with pagination support

`TeamsAppInstallation.ReadWriteSelfForUser`

Bot Get Conversation Member`microsoftteams_bot_get_conversation_member`

Gets details about a specific member of a Bot Framework conversation

`TeamsAppInstallation.ReadWriteSelfForUser`

## Events

Tags

Select all
|
Clear

Channels

Members

Messages

Teams

Webhooks

No tags found

6 events

EventDescriptionTags

Validation Check`microsoftteams_webhook_validation_check`

Responds to Microsoft Graph subscription validation by returning the validationToken as plain text.

Webhooks

Channel Message`microsoftteams_webhook_channel_message`

Fired when a message is posted, edited, or deleted in a Teams channel.

Messages

Chat Message`microsoftteams_webhook_chat_message`

Fired when a message is sent, edited, or deleted in a 1:1 or group chat.

Messages

Team`microsoftteams_webhook_team`

Fired when a team is created, updated, or deleted.

Teams

Channel`microsoftteams_webhook_channel`

Fired when a channel is created, updated, or deleted in any team.

Channels

Chat Member`microsoftteams_webhook_chat_member`

Fired when a member is added to or removed from a 1:1 or group chat.

Members

## References

> [card] [Microsoft Graph API](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
>
> Full REST API reference for Microsoft Graph.

> [card] [Build a bot for Microsoft Teams](https://learn.microsoft.com/en-us/microsoftteams/platform/bots/what-are-bots)
>
> Guide for building bots to leverage the messaging API for agentic use cases.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.