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.
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
Sign in with the Microsoft 365 work or school account whose Teams you want to access.
Review and authorize the requested Microsoft Graph permissions for reading and sending messages and reading team data, then confirm.
Set up in StackAI
Open Settings → Connections, add a connection, and select Microsoft Teams.
Select Connect, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
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
Prepare the Microsoft Teams account or service that the workflow will access. Grant access to the required resources and operations.
Obtain the account, endpoint, and authentication values listed below from the service administrator.
Set up in StackAI
Open Settings → Connections, add a connection, and select Microsoft Teams (App-Only).
Enter the credentials and connection details in the fields below.
Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.
Connection fields
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
Add the required Microsoft Teams action to the workflow.
Select a connection when the action requests one.
Complete the required fields. Use the reference picker when a value comes from another workflow step.
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
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
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
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
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
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
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
Limit
number
No
Maximum number of teams to retrieve (1-999). Defaults to 50. Default: 50.
Outputs
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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: .
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
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.
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
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
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
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?

