Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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

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.

Last updated

Was this helpful?