> 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/integrations/catalog/microsoft-teams.md).

# Microsoft Teams

Microsoft Teams integration providing OAuth2 authentication, channel management, and messaging capabilities. Supports creating channels, sending messages, getting team members, and managing channel messages.

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector                  | Authentication |
| -------------------------- | -------------- |
| Microsoft Teams            | OAuth sign-in  |
| Microsoft Teams (App-Only) | Credentials    |

#### Microsoft Teams

Connect to Microsoft Teams to create channels, send messages, and interact with team data.

**Set up in Microsoft Teams**

1. Sign in with the Microsoft 365 work or school account whose Teams you want to access.
2. Review and authorize the requested Microsoft Graph permissions for reading and sending messages and reading team data, then confirm.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Microsoft Teams**.
2. Select **Connect**, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

StackAI obtains the OAuth credentials during sign-in. You do not need to paste an access token or refresh token.

**Provider documentation:** [Setup reference](https://learn.microsoft.com/en-us/graph/teams-concept-overview).

#### Microsoft Teams (App-Only)

Connect to Microsoft Teams as an application (client credentials) to read meeting transcripts across the organization, including meetings the connected user did not organize. Requires the OnlineMeetingTranscript.Read.All application permission and a Teams Application Access Policy.

**Set up in Microsoft Teams**

1. Prepare the Microsoft Teams account or service that the workflow will access. Grant access to the required resources and operations.
2. Obtain the account, endpoint, and authentication values listed below from the service administrator.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Microsoft Teams (App-Only)**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                           |
| ------------- | -------- | ------------------------------------------------------- |
| Client ID     | Yes      | Application (client) ID of your Azure app registration. |
| Client Secret | Yes      | Client secret of your Azure app registration.           |
| Tenant ID     | Yes      | Directory (tenant) ID of your Azure app registration.   |

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

#### Detailed setup guides

* [Deploy a StackAI interface to Microsoft Teams](https://docs.stackai.com/integrations/catalog/microsoft-teams/deploy-a-stackai-interface-to-microsoft-teams.md)
* [Allow StackAI in Microsoft Entra](https://docs.stackai.com/integrations/catalog/microsoft-entra/allow-stackai-in-microsoft-entra.md)

## Use an action

1. Add the required **Microsoft Teams** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

#### Create Channel

Create a new channel in a Microsoft Teams team

**Inputs**

| Field               | Type            | Required | Description                                                                                                                                                          |
| ------------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Team Name or ID     | select (string) | Yes      | The Microsoft Teams team where the channel will be created. Pick from the dropdown or type a team name or team ID (GUID). Options load from the selected connection. |
| Channel Name        | string          | Yes      | The display name for the new channel.                                                                                                                                |
| Channel Description | string          | No       | Optional description for the new channel. Default: .                                                                                                                 |
| Membership Type     | select (string) | No       | Membership type for the channel. Available options: standard, private. Available values: Standard, Private. Default: standard.                                       |

**Outputs**

| Field          | Type   | Description                                |
| -------------- | ------ | ------------------------------------------ |
| Channel ID     | string | The ID of the created channel.             |
| Channel Name   | string | The name of the created channel.           |
| Channel URL    | string | The web URL to access the channel.         |
| Result Message | string | Summary of the channel creation operation. |

#### Send Channel Message

Send a message to a Microsoft Teams channel

**Inputs**

| Field              | Type            | Required | Description                                                                                                                                               |
| ------------------ | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Team Name or ID    | select (string) | Yes      | The Microsoft Teams team containing the channel. Pick from the dropdown or type a team name or team ID (GUID). Options load from the selected connection. |
| Channel Name or ID | select (string) | Yes      | The channel to send the message to. Pick from the dropdown or type a channel name or channel ID. Options load from the selected connection.               |
| Message            | string          | Yes      | The message content to send to the channel.                                                                                                               |
| Content Type       | select (string) | No       | The content type of the message. Available options: text, html. Available values: Plain Text, HTML. Default: text.                                        |
| Importance         | select (string) | No       | The importance level of the message. Available options: normal, high, urgent. Available values: Normal, High, Urgent. Default: normal.                    |

**Outputs**

| Field            | Type   | Description                               |
| ---------------- | ------ | ----------------------------------------- |
| Message ID       | string | The ID of the sent message.               |
| Message URL      | string | The web URL to view the message.          |
| Created DateTime | string | When the message was created.             |
| Result Message   | string | Summary of the message sending operation. |

#### Send Chat Message

Send a direct chat message to a user in Microsoft Teams

**Inputs**

| Field        | Type            | Required | Description                                                                                                                                            |
| ------------ | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| User         | select (string) | Yes      | The user to send the chat message to. Pick from the dropdown or type a user ID, email/UPN, or display name. Options load from the selected connection. |
| Message      | string          | Yes      | The message content to send in the chat.                                                                                                               |
| Content Type | select (string) | No       | The content type of the message. Available options: text, html. Available values: Plain Text, HTML. Default: text.                                     |
| Importance   | select (string) | No       | The importance level of the message. Available options: normal, high, urgent. Available values: Normal, High, Urgent. Default: normal.                 |

**Outputs**

| Field            | Type   | Description                                    |
| ---------------- | ------ | ---------------------------------------------- |
| Chat ID          | string | The ID of the chat where the message was sent. |
| Message ID       | string | The ID of the sent message.                    |
| Message URL      | string | The web URL to view the message.               |
| Created DateTime | string | When the message was created.                  |
| Result Message   | string | Summary of the message sending operation.      |

#### List Teams

List all Microsoft Teams that the user has access to

**Inputs**

| Field | Type   | Required | Description                                                               |
| ----- | ------ | -------- | ------------------------------------------------------------------------- |
| Limit | number | No       | Maximum number of teams to retrieve (1-999). Defaults to 50. Default: 50. |

**Outputs**

| Field          | Type   | Description                             |
| -------------- | ------ | --------------------------------------- |
| Teams          | string | List of teams the user has access to.   |
| Total Count    | number | Total number of teams returned.         |
| Result Message | string | Summary of the teams listing operation. |

#### List Channels

List all channels in a Microsoft Teams team

**Inputs**

| Field           | Type            | Required | Description                                                                                                                                              |
| --------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Team Name or ID | select (string) | Yes      | The Microsoft Teams team to list channels from. Pick from the dropdown or type a team name or team ID (GUID). Options load from the selected connection. |
| Limit           | number          | No       | Maximum number of channels to retrieve (1-999). Defaults to 50. Default: 50.                                                                             |

**Outputs**

| Field          | Type   | Description                                  |
| -------------- | ------ | -------------------------------------------- |
| Channels       | string | List of channels in the team.                |
| Total Count    | number | Total number of channels returned.           |
| Team ID        | string | The ID of the team these channels belong to. |
| Result Message | string | Summary of the channels listing operation.   |

#### Get Channel Messages

Get messages from a Microsoft Teams channel

**Inputs**

| Field                   | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Team Name or ID         | select (string) | Yes      | The Microsoft Teams team containing the channel. Pick from the dropdown or type a team name or team ID (GUID). Options load from the selected connection.                                                                                                                                                                                                       |
| Channel Name or ID      | select (string) | Yes      | The channel to get messages from. Pick from the dropdown or type a channel name or channel ID. Options load from the selected connection.                                                                                                                                                                                                                       |
| Start Date              | datetime        | No       | Only return messages created at or after this time. Leave empty for no lower bound. A time given without a timezone is read as UTC. Setting either bound scans the 250 most recently active threads, and also clips each thread's replies to the same range.                                                                                                    |
| End Date                | datetime        | No       | Only return messages created before this time. This upper bound is exclusive, so a message posted at exactly this time is left out. Leave empty for no upper bound. A time given without a timezone is read as UTC. Channels are scanned from their most recently active threads, so a range further back than the 250 thread scan reaches may come back empty. |
| Limit                   | number          | No       | Maximum number of top-level messages to retrieve (1-50). Defaults to 20. Most recently active threads come first, and replies are returned in addition to this limit. Default: 20.                                                                                                                                                                              |
| Include Replies         | boolean         | No       | Also retrieve the replies of each message. Replies are returned right after the message they belong to and carry its ID in thread\_id, and they count toward the 500 message total. Every top-level message is always included, so only replies are dropped when that total is reached. Default: false.                                                         |
| Max Replies Per Message | number          | No       | How many replies to retrieve per message (1-100). Defaults to 20. The most recent replies are kept. Ignored unless Include Replies is on. Default: 20.                                                                                                                                                                                                          |

**Outputs**

| Field          | Type          | Description                                                                                                                                                                                                                                      |
| -------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Messages       | object\_array | List of messages from the channel. Each entry carries thread\_id (the ID of the message that started the thread), reply\_to\_id and is\_reply, so replies can be matched to their parent message. reply\_count is 0 unless replies are included. |
| Total Count    | number        | Total number of messages returned.                                                                                                                                                                                                               |
| Team ID        | string        | The ID of the team.                                                                                                                                                                                                                              |
| Channel ID     | string        | The ID of the channel.                                                                                                                                                                                                                           |
| Result Message | string        | Summary of the messages retrieval operation.                                                                                                                                                                                                     |

#### Get Chat

Retrieve a chat by ID from Microsoft Teams, including its members

**Inputs**

| Field | Type            | Required | Description                                                                                                         |
| ----- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| Chat  | select (string) | Yes      | The chat to retrieve. Pick from the dropdown or type a chat ID directly. Options load from the selected connection. |

**Outputs**

| Field                 | Type          | Description                                                         |
| --------------------- | ------------- | ------------------------------------------------------------------- |
| Chat ID               | string        | The ID of the chat.                                                 |
| Chat Type             | string        | The type of chat: oneOnOne, group, or meeting.                      |
| Topic                 | string        | The topic of the chat, empty string if none is set.                 |
| Created DateTime      | string        | ISO 8601 timestamp of when the chat was created.                    |
| Last Updated DateTime | string        | ISO 8601 timestamp of when the chat was last updated.               |
| Web URL               | string        | URL to open the chat in Microsoft Teams.                            |
| Members               | object\_array | List of chat members, each with display\_name, email, and user\_id. |
| Total Members         | number        | Total number of members in the chat.                                |
| Result Message        | string        | Summary of the get chat operation.                                  |

#### Get Meeting Transcripts

Fetch the transcripts of a Microsoft Teams meeting. With the delegated connection, provide a meeting join URL/ID (and optionally an occurrence). With the app-only connection, provide an organizer to read meetings you did not organize — either a specific meeting, or a start/end date range for all of that organizer's meetings. Each transcript is returned as its own file.

**Inputs**

| Field                   | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Organizer               | select (string) | Yes      | App-only only. The organizer whose meeting transcripts to read — required for the app-only connection, since it cannot use 'me'. Pick a user from the dropdown, or type an email or Entra object ID. The dropdown and email lookup need the User.Read.All permission; without it, enter the object ID (GUID) directly. Options load from the selected connection. Default: .                        |
| Meeting                 | select (string) | No       | The Teams meeting to fetch transcripts for. Pick a meeting from the dropdown, or paste a meeting join URL or online meeting ID directly. Required for the delegated connection. For the app-only connection, set Organizer and paste the meeting join URL or online meeting ID here (the dropdown needs the Calendars.Read permission to list meetings). Options load from the selected connection. |
| Start Date              | date            | No       | App-only bulk mode (agent-only, not shown in the form). Start of the date range (UTC) for fetching all of the organizer's meeting transcripts. Used with End Date when no specific meeting is set.                                                                                                                                                                                                  |
| End Date                | date            | No       | App-only bulk mode (agent-only, not shown in the form). End of the date range (UTC) for fetching all of the organizer's meeting transcripts.                                                                                                                                                                                                                                                        |
| Meeting Occurrence      | select (string) | No       | For a recurring meeting, the specific occurrence to fetch. Pick a date/time from the dropdown (populated from the selected meeting). Leave empty to return every occurrence, each as its own file. Options load from the selected connection.                                                                                                                                                       |
| Include Transcript Text | boolean         | No       | Also return each transcript's full text inline, in addition to its file URL. Leave off for long meetings to keep the response small. Default: false.                                                                                                                                                                                                                                                |
| Metadata Only           | boolean         | No       | When on, list the transcripts without downloading any of them: you get each occurrence's date and meeting ID, but no file and no text. Use it to see which occurrences exist before fetching the one you want. Default: false.                                                                                                                                                                      |

**Outputs**

| Field                            | Type          | Description                                                                                                                                                                        |
| -------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Meeting ID                       | string        | The resolved online meeting ID.                                                                                                                                                    |
| Transcripts                      | object\_array | One entry per meeting occurrence, each with its own downloadable transcript file. Fields: transcript\_id, created\_datetime, file\_url, and text.                                  |
| Total Transcripts                | number        | Number of transcripts returned for the meeting.                                                                                                                                    |
| Result Message                   | string        | Summary of the fetch transcripts operation.                                                                                                                                        |
| Transcript File URL (deprecated) | string        | Deprecated, kept for backward compatibility: a single merged file containing every returned occurrence's transcript. Prefer transcripts\[].file\_url for the per-occurrence files. |
| Transcript Text (deprecated)     | string        | Deprecated, kept for backward compatibility: every returned transcript's text joined together (only when Include Transcript Text is on). Prefer transcripts\[].text.               |

#### List Meetings

List Teams online meetings and their join URLs, so you can find a meeting by name. With the delegated connection this lists your own meetings; with the app-only connection, set an organizer to list theirs.

**Inputs**

| Field         | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                        |
| ------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Organizer     | select (string) | Yes      | App-only only. The user whose meetings to list, required for the app-only connection since it cannot use 'me'. Pick a user from the dropdown, or type an email or Entra object ID; both work. Only the dropdown needs the User.Read.All permission, to enumerate users, so you can type an email without it. Options load from the selected connection. Default: . |
| Name Contains | string          | No       | Optional. Only return meetings whose subject contains this text (case-insensitive).                                                                                                                                                                                                                                                                                |
| Cursor        | string          | No       | Optional. Continue a previous listing that reported more meetings remaining. Paste the Next Cursor value from that run; leave empty to start from the most recent events.                                                                                                                                                                                          |
| Limit         | number          | No       | Maximum number of meetings to return (1-200). Defaults to 50.                                                                                                                                                                                                                                                                                                      |

**Outputs**

| Field          | Type          | Description                                                                                                                   |
| -------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Meetings       | object\_array | The user's Teams online meetings, most recently started first. Fields: subject, start\_datetime, join\_url and is\_recurring. |
| Total Count    | number        | Number of meetings returned.                                                                                                  |
| Truncated      | boolean       | True when meetings were left out, either trimmed by the limit or beyond the part of the calendar that was read.               |
| Next Cursor    | string        | Set when the calendar was not read to the end. Pass it back as Cursor to continue from where this run stopped.                |
| Result Message | string        | Summary of the list meetings operation.                                                                                       |

#### Get Team Members

Get all members of a Microsoft Teams team. Note: Detailed user information (display name, email) requires User.ReadBasic.All permission.

**Inputs**

| Field           | Type            | Required | Description                                                                                                                                            |
| --------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Team Name or ID | select (string) | Yes      | The Microsoft Teams team to get members from. Pick from the dropdown or type a team name or team ID (GUID). Options load from the selected connection. |
| Limit           | number          | No       | Maximum number of members to retrieve (1-999). Defaults to 50. Default: 50.                                                                            |

**Outputs**

| Field          | Type   | Description                                 |
| -------------- | ------ | ------------------------------------------- |
| Members        | string | List of members in the team.                |
| Total Count    | number | Total number of members returned.           |
| Team ID        | string | The ID of the team these members belong to. |
| Result Message | string | Summary of the members retrieval operation. |

#### Reply to Message

Reply to a message in a Microsoft Teams channel

**Inputs**

| Field              | Type            | Required | Description                                                                                                                                               |
| ------------------ | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Team Name or ID    | select (string) | Yes      | The Microsoft Teams team containing the channel. Pick from the dropdown or type a team name or team ID (GUID). Options load from the selected connection. |
| Channel Name or ID | select (string) | Yes      | The channel containing the message to reply to. Pick from the dropdown or type a channel name or channel ID. Options load from the selected connection.   |
| Message ID         | string          | Yes      | The ID of the message to reply to.                                                                                                                        |
| Reply Message      | string          | Yes      | The content of the reply message.                                                                                                                         |
| Content Type       | select (string) | No       | The content type of the reply message. Available options: text, html. Available values: Plain Text, HTML. Default: text.                                  |
| Importance         | select (string) | No       | The importance level of the reply message. Available options: normal, high, urgent. Available values: Normal, High, Urgent. Default: normal.              |

**Outputs**

| Field               | Type   | Description                                         |
| ------------------- | ------ | --------------------------------------------------- |
| Reply ID            | string | The ID of the reply message.                        |
| Original Message ID | string | The ID of the original message that was replied to. |
| Reply URL           | string | The web URL to view the reply.                      |
| Created DateTime    | string | When the reply was created.                         |
| Result Message      | string | Summary of the reply operation.                     |

#### Get User Presence

Get presence and availability information for any user in your Microsoft Teams organization

**Inputs**

| Field | Type            | Required | Description                                                                                                                                      |
| ----- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| User  | select (string) | Yes      | The user to check presence for. Pick from the dropdown or type a user ID, email/UPN, or display name. Options load from the selected connection. |

**Outputs**

| Field                 | Type   | Description                                                                          |
| --------------------- | ------ | ------------------------------------------------------------------------------------ |
| User ID               | string | The ID of the user.                                                                  |
| Availability          | string | The availability status (Available, Busy, DoNotDisturb, BeRightBack, Away, Offline). |
| Activity              | string | The current activity status.                                                         |
| Status Message        | string | The user's custom status message.                                                    |
| Out of Office Message | string | The user's out of office message if set.                                             |
| Result Message        | string | Summary of the presence check operation.                                             |

### Triggers

A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.

#### New Chat Message

Trigger a workflow execution when a new message is posted to a Teams chat.

**Configuration**

| Field           | Type            | Required | Description                                                                                                                                                                        |
| --------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Chat            | select (string) | Yes      | The Microsoft Teams chat to monitor for new messages. Options load from the selected connection.                                                                                   |
| Check Frequency | select (string) | No       | How often to check Microsoft Teams for new chat messages. Available values: Every minute, Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_minute. |

**Event inputs**

| Field                  | Type   | Required | Description                                               |
| ---------------------- | ------ | -------- | --------------------------------------------------------- |
| Message ID             | string | Yes      | The Microsoft Teams message ID.                           |
| Chat ID                | string | Yes      | The Microsoft Teams chat ID where the message was posted. |
| Created Datetime       | string | Yes      | When the message was created, in ISO 8601 format.         |
| Last Modified Datetime | string | No       | When the message was last modified, in ISO 8601 format.   |
| Message Type           | string | No       | The Teams message type.                                   |
| Importance             | string | No       | The Microsoft Teams message importance level.             |
| Web URL                | string | No       | A web URL for the Teams message.                          |
| Reply To ID            | string | No       | The parent message ID if this message is a reply.         |
| Sender ID              | string | No       | The Teams sender ID for the message author.               |
| Sender Name            | string | No       | The display name of the message author.                   |
| Sender Email           | string | No       | The email address of the message author when available.   |
| Message Content        | string | Yes      | The plain-text Teams message body.                        |

**Outputs**

| Field                  | Type   | Description                                               |
| ---------------------- | ------ | --------------------------------------------------------- |
| Message ID             | string | The Microsoft Teams message ID.                           |
| Chat ID                | string | The Microsoft Teams chat ID where the message was posted. |
| Created Datetime       | string | When the message was created, in ISO 8601 format.         |
| Last Modified Datetime | string | When the message was last modified, in ISO 8601 format.   |
| Message Type           | string | The Teams message type.                                   |
| Importance             | string | The Microsoft Teams message importance level.             |
| Web URL                | string | A web URL for the Teams message.                          |
| Reply To ID            | string | The parent message ID if this message is a reply.         |
| Sender ID              | string | The Teams sender ID for the message author.               |
| Sender Name            | string | The display name of the message author.                   |
| Sender Email           | string | The email address of the message author when available.   |
| Message Content        | string | The plain-text Teams message body.                        |

#### New Channel

Trigger a workflow execution when a new Teams channel is created.

**Configuration**

| Field           | Type            | Required | Description                                                                                                                                                                   |
| --------------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Team            | select (string) | Yes      | The Microsoft Teams team to monitor for newly created channels. Options load from the selected connection.                                                                    |
| Check Frequency | select (string) | No       | How often to check Microsoft Teams for newly created channels. Available values: Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_5\_minutes. |

**Event inputs**

| Field            | Type   | Required | Description                                       |
| ---------------- | ------ | -------- | ------------------------------------------------- |
| Channel ID       | string | Yes      | The Microsoft Teams channel ID.                   |
| Team ID          | string | Yes      | The Microsoft Teams team ID.                      |
| Display Name     | string | Yes      | The Microsoft Teams channel display name.         |
| Description      | string | No       | The Microsoft Teams channel description.          |
| Membership Type  | string | No       | The Microsoft Teams channel membership type.      |
| Created Datetime | string | Yes      | When the channel was created, in ISO 8601 format. |
| Web URL          | string | No       | A web URL for the Teams channel.                  |

**Outputs**

| Field            | Type   | Description                                       |
| ---------------- | ------ | ------------------------------------------------- |
| Channel ID       | string | The Microsoft Teams channel ID.                   |
| Team ID          | string | The Microsoft Teams team ID.                      |
| Display Name     | string | The Microsoft Teams channel display name.         |
| Description      | string | The Microsoft Teams channel description.          |
| Membership Type  | string | The Microsoft Teams channel membership type.      |
| Created Datetime | string | When the channel was created, in ISO 8601 format. |
| Web URL          | string | A web URL for the Teams channel.                  |

#### New Chat

Triggers when a new chat starts (1:1 or group), not for messages in existing chats.

**Configuration**

| Field           | Type            | Required | Description                                                                                                                                                                          |
| --------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Check Frequency | select (string) | No       | How often to check Microsoft Teams for newly created chats. Available values: Every minute, Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_minute. |

**Event inputs**

| Field                 | Type   | Required | Description                                         |
| --------------------- | ------ | -------- | --------------------------------------------------- |
| Chat ID               | string | Yes      | The Microsoft Teams chat ID.                        |
| Topic                 | string | No       | The Microsoft Teams chat topic when available.      |
| Chat Type             | string | No       | The Microsoft Teams chat type.                      |
| Created Datetime      | string | Yes      | When the chat was created, in ISO 8601 format.      |
| Last Updated Datetime | string | No       | When the chat was last updated, in ISO 8601 format. |
| Web URL               | string | No       | A web URL for the Teams chat.                       |

**Outputs**

| Field                 | Type   | Description                                         |
| --------------------- | ------ | --------------------------------------------------- |
| Chat ID               | string | The Microsoft Teams chat ID.                        |
| Topic                 | string | The Microsoft Teams chat topic when available.      |
| Chat Type             | string | The Microsoft Teams chat type.                      |
| Created Datetime      | string | When the chat was created, in ISO 8601 format.      |
| Last Updated Datetime | string | When the chat was last updated, in ISO 8601 format. |
| Web URL               | string | A web URL for the Teams chat.                       |

#### New Channel Message

Trigger a workflow execution when a new message is posted to a Microsoft Teams channel.

**Configuration**

| Field                  | Type            | Required | Description                                                                                                                                                                               |
| ---------------------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Team                   | select (string) | Yes      | The Microsoft Teams team to monitor for new messages. Options are loaded from the connected account. Options load from the selected connection.                                           |
| Channel                | select (string) | Yes      | The channel to monitor for new messages. Options are loaded from the selected team. Options load from the selected connection.                                                            |
| Check Frequency        | select (string) | No       | How often to check Microsoft Teams for new channel messages. Available values: Every minute, Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_5\_minutes. |
| Ignore My Own Messages | boolean         | No       | Skip messages sent by the connected account, so a workflow that posts into this channel does not trigger itself. Default: true.                                                           |

**Event inputs**

| Field            | Type   | Required | Description                                            |
| ---------------- | ------ | -------- | ------------------------------------------------------ |
| Message ID       | string | Yes      | The ID of the new message.                             |
| Message Content  | string | Yes      | The content of the new message.                        |
| Sender ID        | string | No       | The Teams sender ID for the message author.            |
| Sender Name      | string | Yes      | The name of the user who sent the message.             |
| Sender Email     | string | No       | The email of the user who sent the message. Default: . |
| Created DateTime | string | Yes      | When the message was created.                          |
| Message URL      | string | No       | The web URL to view the message. Default: .            |
| Importance       | string | No       | The importance level of the message. Default: .        |

**Outputs**

| Field            | Type   | Description                                 |
| ---------------- | ------ | ------------------------------------------- |
| Message ID       | string | The ID of the new message.                  |
| Message Content  | string | The content of the new message.             |
| Sender ID        | string | The Teams sender ID for the message author. |
| Sender Name      | string | The name of the user who sent the message.  |
| Sender Email     | string | The email of the user who sent the message. |
| Created DateTime | string | When the message was created.               |
| Message URL      | string | The web URL to view the message.            |
| Importance       | string | The importance level of the message.        |

#### On New Team Member

Trigger a workflow execution when a new member is added to a Teams team.

**Configuration**

| Field           | Type            | Required | Description                                                                                                                                                                     |
| --------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Team            | select (string) | Yes      | The Microsoft Teams team to monitor for newly added members. Options load from the selected connection.                                                                         |
| Check Frequency | select (string) | No       | How often to check Microsoft Teams for newly added team members. Available values: Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_5\_minutes. |

**Event inputs**

| Field               | Type          | Required | Description                                                               |
| ------------------- | ------------- | -------- | ------------------------------------------------------------------------- |
| Member ID           | string        | Yes      | The Microsoft Teams membership ID.                                        |
| Team ID             | string        | Yes      | The Microsoft Teams team ID.                                              |
| User ID             | string        | Yes      | The Microsoft Entra user ID when available.                               |
| Display Name        | string        | No       | The Microsoft Teams member display name when available. Default: .        |
| Email               | string        | No       | The Microsoft Teams member email when available. Default: .               |
| Roles               | string\_array | No       | The Microsoft Teams roles assigned to the member.                         |
| User Principal Name | string        | No       | The Microsoft Teams member user principal name when available. Default: . |
| Tenant ID           | string        | No       | The Microsoft Entra tenant ID associated with the member. Default: .      |

**Outputs**

| Field               | Type          | Description                                                    |
| ------------------- | ------------- | -------------------------------------------------------------- |
| Member ID           | string        | The Microsoft Teams membership ID.                             |
| Team ID             | string        | The Microsoft Teams team ID.                                   |
| User ID             | string        | The Microsoft Entra user ID when available.                    |
| Display Name        | string        | The Microsoft Teams member display name when available.        |
| Email               | string        | The Microsoft Teams member email when available.               |
| Roles               | string\_array | The Microsoft Teams roles assigned to the member.              |
| User Principal Name | string        | The Microsoft Teams member user principal name when available. |
| Tenant ID           | string        | The Microsoft Entra tenant ID associated with the member.      |

#### New Team

Trigger a workflow execution when the authenticated user joins a new Teams team.

Microsoft Graph joinedTeams does not include host teams for shared-channel memberships, so those joins will not trigger events.

**Required permissions:** `Team.ReadBasic.All`.

**Configuration**

| Field           | Type            | Required | Description                                                                                                                                                               |
| --------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Check Frequency | select (string) | No       | How often to check Microsoft Teams for newly joined teams. Available values: Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_5\_minutes. |

**Event inputs**

| Field        | Type    | Required | Description                                                   |
| ------------ | ------- | -------- | ------------------------------------------------------------- |
| Team ID      | string  | Yes      | The Microsoft Teams team ID.                                  |
| Display Name | string  | No       | The Microsoft Teams team display name. Default: .             |
| Description  | string  | No       | The Microsoft Teams team description. Default: .              |
| Is Archived  | boolean | No       | Whether the Microsoft Teams team is archived. Default: false. |
| Tenant ID    | string  | No       | The Microsoft Entra tenant ID for the team. Default: .        |

**Outputs**

| Field        | Type    | Description                                   |
| ------------ | ------- | --------------------------------------------- |
| Team ID      | string  | The Microsoft Teams team ID.                  |
| Display Name | string  | The Microsoft Teams team display name.        |
| Description  | string  | The Microsoft Teams team description.         |
| Is Archived  | boolean | Whether the Microsoft Teams team is archived. |
| Tenant ID    | string  | The Microsoft Entra tenant ID for the team.   |

### Important behavior

If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# 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/integrations/catalog/microsoft-teams.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.
