Microsoft Teams

These are the Microsoft Teams actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Add chat member

  Tool to add a conversationMember to a Microsoft Teams chat. Use when adding a user to an existing chat conversation.

• Add member to channel

  Tool to add a member to a Microsoft Teams channel. Use this action when you need to grant a user access to a specific channel within a team, or when you need to add an owner to manage the channel.

• Add member to team

  (DEPRECATED: use `MICROSOFT_TEAMS_ADD_TEAM_MEMBER`) Tool to add a user to a Microsoft Teams team. Use when granting or updating membership for a user.

• Add member to team

  Tool to add a user to a Microsoft Teams team. Use when granting or updating membership for a user.

• Add team members (bulk)

  Tool to add multiple members to a Microsoft Teams team in a single operation. Use when adding several users at once to improve efficiency.

• Archive channel

  Tool to archive a channel in a Microsoft Teams team. Use when you need to archive a specific channel within a team.

• Archive team channel

  Tool to archive a channel in a Microsoft Teams team using the group ID. Use when you need to archive a specific channel within a team.

• Archive Teams team

  Tool to archive a Microsoft Teams team. Use after confirming the team ID; returns 202 if accepted.

• Clone Team

  Tool to clone a Microsoft Teams team using the team ID. Use when you need to create a copy of an existing team including its structure, channels, and tabs. This is an asynchronous operation; poll the returned location URL to monitor progress.

• Create Call Operation

  Tool to create a new operation for a communications call. Use when you need to initiate a new operation on an active call.

• Create Chat

  Creates a new chat; if a 'oneOnOne' chat with the specified members already exists, its details are returned, while 'group' chats are always newly created. IMPORTANT: The authenticated user MUST be included as one of the members.

• Create online meeting

  Use to schedule a new standalone Microsoft Teams online meeting, i.e., one not linked to any calendar event.

• Create open shifts

  Tool to create a new open shift in a Microsoft Teams team schedule. Use when you need to publish available shifts that team members can claim.

• Create Team

  Tool to create a new Microsoft Teams team. Use when you need to provision a team with optional template, channels, and members.

• Create Team From Group

  Tool to create a new team under an existing Microsoft 365 group. Use when you need to add Teams capabilities to an existing group.

• Create team schedule shift

  Tool to create a new shift in a Microsoft Teams team schedule. Use when you need to assign work shifts to team members with specific start/end times and details.

• Create time off

  Tool to create a new timeOff instance in a team's schedule. Use when you need to create approved time off for a team member (vacation, sick leave, etc.).

• Create time off reason

  Tool to create a new time off reason in a team's schedule. Use when you need to define a new category for time off requests with a custom name and icon.

• Delete channel tab

  Tool to delete a tab from a Microsoft Teams channel. Use when you need to permanently remove a tab from a channel.

• Delete open shift

  Tool to delete an open shift from a Microsoft Teams schedule. Use when you need to remove an unfilled shift from the team schedule.

• Delete team channel

  Tool to delete a channel from a Microsoft Teams team. Use when you need to permanently remove a channel. Note that the General channel cannot be deleted.

• Delete team schedule day note

  Tool to delete a day note from a Microsoft Teams schedule. Use when you need to remove a day note from a specific date in the team schedule. The If-Match header with ETag value is required for deletion.

• Delete team schedule shift

  Tool to delete a shift from a Microsoft Teams team schedule. Use when you need to permanently remove a scheduled shift.

• Delete team scheduling group

  Tool to delete a scheduling group from a Microsoft Teams team schedule. Use this when you need to remove a scheduling group from a specific team.

• Delete Teams team

  Tool to delete a Microsoft Teams team. Use after confirming the target team ID.

• Delete time off

  Tool to delete a timeOff from a team's schedule. Use when you need to remove a scheduled time off entry from a team member's schedule.

• Delete time off reason

  Tool to delete a time off reason from a team's schedule. Use when you need to remove a time off reason. Note: This operation marks the time off reason as inactive rather than permanently deleting it.

• Delete time off request

  Tool to delete a time off request from a Microsoft Teams team schedule. Use when you need to permanently remove a time off request.

• Delete User Online Meeting

  Tool to delete an online meeting for a user. Use when you need to permanently remove an online meeting from a user's calendar.

• Get chat message

  Tool to get a specific chat message. Use after confirming chat_id and message_id.

• Get meeting transcript content

  Retrieve the raw text/vtt content for a Microsoft Teams meeting transcript. Use this after listing meeting transcripts and selecting a transcript ID. The Microsoft Graph transcript APIs only support calendar-backed online meetings that have an available transcript; standalone meetings created only with the create onlineMeeting API can return 412.

• Get primary channel

  Tool to get the default (General) channel of a team. Use when you need to access the primary channel without knowing its channel ID.

• Get schedule

  Tool to retrieve the properties and relationships of a schedule object. Use when you need to get schedule configuration details for a team.

• Get Team

  Tool to get a specific team. Use when full details of one team by ID are needed.

• Get team channel

  Tool to get a specific channel in a team. Use after obtaining valid team and channel IDs to fetch channel details.

• Get Team Operation Status

  Tool to retrieve the status of a Teams async operation using teamId and operationId. Use when you need to poll and track the progress of long-running operations like team creation or archiving. Microsoft recommends waiting at least 30 seconds between polling requests.

• Get time off reason

  Tool to get a specific time off reason from a team's schedule. Use when you need to retrieve details about a time off reason including its display name, icon type, and active status.

• Get User Profile

  Tool to retrieve a user's profile (id/UPN/mail/displayName). Supports both delegated auth (use user_id='me') and application-only auth (specify user ID/UPN). Use when operations require user identity information (e.g., chat creation).

• List channel messages

  Tool to list messages in a Teams channel when team_id and channel_id are known (no chat_id required). Use this to enumerate channel message history and obtain message_id for follow-on operations like listing replies or getting message details.

• List Communications Call Operations

  Tool to list operations on a Microsoft Teams call. Use when you need to retrieve the status of long-running operations like adding large gallery views, recording, or playing prompts on an active call.

• List Group Team Operations

  Tool to list operations on a group's team. Use when you need to retrieve all async operations (such as team creation, archiving, channel creation) for a specific group's team.

• List meeting transcripts

  List meeting transcripts for a Microsoft Teams online meeting. Retrieves all transcripts associated with a specific meeting, including metadata such as creation time, meeting organizer, and content URL. Use this action when you need to access or review the transcription records of a meeting, for example to extract meeting notes, analyze discussion topics, or maintain compliance records.

• List team members

  Tool to list members of a Microsoft Teams team. Use when you need to retrieve the members of a specific team, for auditing or notifications.

• List Team Operations

  Tool to list operations from a team. Use when you need to retrieve all async operations (such as team creation, archiving, channel creation) for a specific team.

• List user's chat members

  Tool to list members of a specific chat for a user in Microsoft Teams. Use when you need to retrieve the members of a specific user's chat, whether it's a one-on-one chat, group chat, or meeting chat.

• Remove channel email address

  Tool to remove the email address of a channel in Microsoft Teams. Use when you need to disable email integration for a specific channel.

• Remove chat member

  Tool to remove a member from a Microsoft Teams chat. Use when you need to remove a user from a chat conversation.

• Remove team member

  Tool to remove a member from a Microsoft Teams team. Use when you need to remove a user from a team.

• Remove team members

  Tool to remove multiple members from a Microsoft Teams team in bulk. Use when you need to remove one or more users from a team.

• Search Teams files

  Search files in Microsoft Teams using KQL syntax. Find files by name, type, content, author, and modification date across all Teams and channels. Supports boolean logic and date ranges. Examples: 'filetype:pdf AND lastmodifiedtime>=2024-10-01', 'contract AND budget', 'filename:report AND author:user@example.com'

• Search Teams messages

  Search Microsoft Teams messages using powerful KQL syntax. Supports sender (from:), date filters (sent:), attachments, and boolean logic. Works across all Teams chats and channels the user has access to. Examples: 'from:user@example.com AND sent>=2024-10-01', 'punchlist OR termination', 'sent>today-30 AND hasattachment:yes' NOTE: This action requires an organizational Microsoft 365 account (Azure AD/Entra ID). It does NOT work with personal Microsoft accounts (MSA) such as @outlook.com, @hotmail.com, or @live.com. If using a personal Microsoft account, this search will fail.

• Set Presence

  Tool to set the presence information for a user's application presence session. Use when you need to update a user's presence state in Microsoft Teams. Valid combinations: Available/Available, Busy/InACall, Busy/InAConferenceCall, Away/Away, or DoNotDisturb/Presenting.

• Set User Preferred Presence

  Tool to set the preferred availability and activity status for a user. Use when you need to update a user's presence status in Microsoft Teams. Preferred presence takes effect only when at least one presence session exists for the user.

• Soft-delete Teams channel message

  Tool to soft-delete a message in a Teams channel. Use when you need to remove a message without permanently deleting it.

• Unarchive channel

  Tool to unarchive a channel in a Microsoft Teams team. Use when you need to restore an archived channel to active state.

• Unarchive group team channel

  Tool to unarchive a channel in a Microsoft Teams group's team. Use when you need to restore an archived channel to active state.

• Unarchive Teams team

  Tool to unarchive a Microsoft Teams team. Use when you need to restore an archived team to active state.

• Unpin chat message

  Tool to unpin a message from a Microsoft Teams chat. Use when you need to remove a pinned message.

• Update Call Operation

  Tool to update the navigation property operations in communications. Use when you need to modify properties of an existing call operation.

• Update Chat

  Tool to update the properties of a chat. Use when you need to modify chat settings such as the topic.

• Update open shift

  Tool to update an existing open shift in a Microsoft Teams team schedule. Use when you need to modify open shift details such as times, theme, notes, or open slot count.

• Update Team

  Tool to update the properties of a team. Use when you need to modify team settings such as member, messaging, or fun settings.

• Update team member

  Tool to update a team member's roles or properties in Microsoft Teams. Use when you need to change a member's role (e.g., promote to owner or demote to member).

• Update team schedule shift

  Tool to update an existing shift in a Microsoft Teams team schedule. Use when you need to modify shift details like times, assigned user, or notes.

• Update Teams channel

  Tool to update channel properties in a Microsoft Teams group. Use when you need to modify channel description, display name, or favorite settings.

• Update Teams channel message

  Tool to update a message in a channel. Use when you need to modify an existing channel message after confirming channel and message IDs.

• Update Teams channel tab

  Tool to update the properties of a tab in a Microsoft Teams channel. Use when you need to modify tab display name, configuration, or web URL.

• Update Teams chat message

  Tool to update a specific message in a chat. Use when you need to correct or modify a sent chat message.

• Update time off

  Tool to replace an existing timeOff entry in a team's schedule. Use when you need to update time off details including dates, reason, or status.

• Update time off reason

  Tool to update a time off reason in a team's schedule. Use when you need to modify the display name, icon, active status, or code of an existing time off reason.

• Add tab to channel

  Tool to add a new tab to a Microsoft Teams channel. Use when you need to pin an app or website as a tab in a channel.

• Clear Automatic Location

  Tool to clear the automatic location from a user's presence in Microsoft Teams. Use when you need to remove automatically-set location information from presence status.

• Clear Presence

  Tool to clear the presence information for a user's application presence session in Microsoft Teams. Use when you need to remove presence information set by an application for the authenticated user. Note: This action can only clear presence for the authenticated user, not for other users.

• Clear Presence Location

  Tool to clear the authenticated user's presence location. Use when you need to remove location information from the user's current presence status.

• Clear User Preferred Presence

  Tool to clear a user's preferred presence setting in Microsoft Teams. Use when you need to remove the user's manually set presence status and allow the system to automatically determine their presence based on activity. Supports both delegated (user) and application (S2S) authentication.

• Create a channel

  Tool to create a new standard, private, or shared channel within a Microsoft Teams team. Use when you need to create a new channel for team collaboration.

• Create a channel

  (DEPRECATED: use `MICROSOFT_TEAMS_CREATE_CHANNEL`) Tool to create a new standard, private, or shared channel within a Microsoft Teams team. Use when you need to create a new channel for team collaboration.

• Create channel in group team

  Tool to create a new channel in a group's associated team. Use when you have a group ID and need to create a channel in its team.

• Create Content Sharing Session

  Tool to create a content sharing session in a Microsoft Teams call. Use when you need to initiate content sharing during an active call.

• Create open shift change request

  Tool to create a new open shift change request in a team schedule. Use when a team member wants to claim an available open shift.

• Create or get online meeting

  Tool to create a new Microsoft Teams online meeting or retrieve an existing one based on externalId. Use when you need an idempotent meeting creation operation that returns an existing meeting if the externalId matches.

• Create or update schedule

  Tool to create or replace a schedule object for a Microsoft Teams team. Use when you need to enable or configure scheduling features for a team.

• Create schedule day note

  Tool to create a new day note in a team's schedule. Use when you need to add notes or reminders for a specific date in the team schedule. Day notes help communicate important information to team members for a particular day.

• Create scheduling group

  Tool to create a new scheduling group in a team's schedule. Use when you need to organize team members into groups for shift scheduling and management. This action uses 'team_id' parameter naming which aligns with the Microsoft Graph API endpoint (/teams/{id}/schedule/schedulingGroups).

• Create time off request

  Tool to create a new time off request in a team's schedule. Use when a team member needs to request time off for vacation, sick leave, or other absences.

• Create user offer shift request

  Tool to create a new offer shift request in a user's joined team schedule. Use when a team member wants to offer their shift to another team member.

• Create user online meeting

  Tool to create a new Microsoft Teams online meeting for a specific user. Use when you need to create an online meeting on behalf of a user.

• Delete Call Operation

  Tool to delete a navigation property operation for a communications call. Use when you need to remove a specific commsOperation from a call.

• Get all chats

  Retrieves all Microsoft Teams chats a specified user is part of, supporting filtering, property selection, and pagination.

• Get call operation

  Tool to get a specific commsOperation for a call. Use to check the status of long-running call operations.

• Get channel files folder

  Tool to get the files folder (DriveItem) metadata for a specific channel in a Microsoft Teams team. Use when you need to access file storage information for a channel.

• Get channel message reply

  Tool to retrieve a single reply to a message in a channel. Use when you need to get details of a specific reply message.

• Get channel tab

  Tool to get a specific tab in a Microsoft Teams channel. Use when you need to retrieve details of a particular tab.

• Get chat

  Tool to retrieve a single chat by ID. Use when you need to get details about a specific chat.

• Get chat member

  Tool to get a specific conversation member from a Microsoft Teams chat. Use when you need details about a specific chat participant.

• Get day note

  Tool to retrieve a specific day note from a team's schedule. Use when you need to view notes for a specific date in a team's schedule.

• Get installed app in team

  Tool to get an installed app in a Microsoft Teams team. Use when you need to retrieve details of a specific app installation.

• Get offer shift request

  Tool to get a specific offer shift request from a Microsoft Teams schedule. Use when you need to retrieve details of a single offer shift request by its ID.

• Get online meeting

  Tool to retrieve details of a specific Microsoft Teams online meeting by its ID. Use when you need to get the properties and relationships of an existing meeting.

• Get open shift

  Tool to get a specific open shift from a Microsoft Teams schedule. Use when you need to retrieve details about a particular unassigned open shift by its ID.

• Get open shift change request

  Tool to retrieve a specific open shift change request from a Microsoft Teams team's schedule. Use when you need to get details about a particular open shift request including its state, sender, and manager actions.

• Get scheduling group

  Tool to retrieve a specific scheduling group from a Microsoft Teams team's schedule. Use when you need to get details about a scheduling group including its members, status, and metadata.

• Get shift

  Tool to retrieve a shift by ID from a Microsoft Teams team schedule. Use when you need to get details of a specific shift assignment.

• Get swap shifts change request

  Tool to get a specific swap shift change request from a Microsoft Teams schedule. Use when you need to retrieve details of a single swap shift change request by its ID.

• Get team member

  Tool to get a specific conversation member from a team. Use when retrieving details about a team member by their membership ID.

• Get Teams channel message

  Retrieves a specific message from a Microsoft Teams channel using its Team, Channel, and Message IDs.

• Get time off by ID

  Tool to retrieve a specific time off entry from a Microsoft Teams team's schedule by ID. Use when you need to get details about a particular time off period including its dates, reason, and status.

• Get time off request

  Tool to retrieve a specific time off request from a team's schedule. Use when you need to check the status or details of a time off request.

• Get user chat

  Tool to retrieve a specific chat for a user. Use when you need to get details about a chat that a specific user is part of.

• Get User Presence

  Tool to get a specific user's presence information. Use when checking availability status, activity, or work location for a particular user.

• Get User Teamwork

  Tool to get userTeamwork settings for a specified user, including Microsoft Teams region and locale. Use when you need to determine user's Teams configuration or regional settings.

• Hide chat for user

  Tool to hide a Microsoft Teams chat for a specific user. Use when you need to hide a chat from a user's chat list. Note: The chat is automatically unhidden if an action such as sending a message is taken at the chat level.

• List channel message replies

  Tool to list all replies to a specific message in a Microsoft Teams channel. Use when you need to retrieve the conversation thread for a particular message.

• List channel tabs

  Tool to list tabs from a Microsoft Teams channel. Use when you need to retrieve all tabs configured in a specific channel. Note: The Files tab (native to channels) is not returned by this API.

• List deleted teams

  Tool to list deleted Microsoft Teams and their properties. Use when you need to retrieve a list of teams that have been deleted.

• List installed apps in team

  Tool to list apps installed in a Microsoft Teams team. Use when you need to retrieve the collection of apps installed in a specific team.

• List offer shift requests

  Tool to list offer shift requests in a Microsoft Teams schedule. Use when you need to retrieve all offer shift requests for a team's schedule.

• List open shift change requests

  Tool to list open shift change requests in a Microsoft Teams schedule. Use when you need to retrieve all open shift requests for a team's schedule.

• List open shifts

  Tool to list open shifts in a Microsoft Teams schedule. Use when you need to retrieve all unassigned open shifts for a team's schedule.

• List People

  Retrieves a list of people relevant to a specified user from Microsoft Graph, noting the `search` parameter is only effective if `user_id` is 'me'.

• List pinned messages

  Tool to retrieve the list of pinned messages in a Microsoft Teams chat. Use when you need to get all messages that have been pinned in a specific chat conversation.

• List scheduling groups

  Tool to list scheduling groups in a team's schedule. Use when you need to retrieve all scheduling groups for shift management and organization.

• List shifts

  Tool to list shifts in a Microsoft Teams schedule. Use when you need to retrieve all shifts for a team's schedule.

• List swap shifts change requests

  Tool to list swap shift change requests in a Microsoft Teams schedule. Use when you need to retrieve all swap shift requests for a team's schedule.

• List team channels

  Retrieves channels for a specified Microsoft Teams team ID (must be valid and for an existing team), with options to include shared channels, filter results, and select properties.

• List team incoming channels

  Tool to list incoming channels shared with a Microsoft Teams team. Use when you need to view channels from other teams that have been shared with this team.

• List team schedule day notes

  Tool to list all dayNotes from a team's schedule. Use when you need to retrieve all day notes or search/filter notes for specific dates in a team's schedule.

• List team schedule time off reasons

  Tool to get time off reasons from a team's schedule. Use when you need to retrieve the list of available time off reasons for scheduling in Microsoft Teams.

• List team time off entries

  Tool to list time off entries from a Microsoft Teams team's schedule. Use when you need to retrieve all time off periods for a team.

• List Teams

  Retrieves Microsoft Teams accessible by the authenticated user, allowing filtering, property selection, and pagination.

• List teams permission grants

  Tool to list all resource-specific permission grants for a team with support for filtering, pagination, and sorting. Use when you need to identify which Microsoft Entra apps have access to a team and their corresponding permissions.

• List Teams templates

  Tool to list available Microsoft Teams templates. Use when retrieving templates for team creation or customization workflows.

• List time off requests

  Tool to retrieve a list of time off requests from a Microsoft Teams team's schedule. Use when you need to view all time off requests including their status (pending, approved, declined), dates, and associated users.

• List user chat messages

  Tool to retrieve messages from a specific chat for a given user. Use when you need to access chat messages through the user context.

• List user joined teams

  Tool to list the Teams that a specified user is a direct member of (joined teams). Use for access/membership audits when enumerating team members is access-restricted.

• List user online meetings

  Look up a Microsoft Teams online meeting for a user by identifier. This is effectively a 'lookup-by-identifier' endpoint, NOT a general-purpose list or search. Microsoft Graph REQUIRES an OData $filter predicate on /me/onlineMeetings and /users/{user_id}/onlineMeetings; without it the API returns HTTP 400 'Filter expression expected'. The only supported filter properties on this endpoint are JoinWebUrl and joinMeetingIdSettings/joinMeetingId (e.g. "JoinWebUrl eq 'https://teams.microsoft.com/l/meetup-join/...'" or "joinMeetingIdSettings/joinMeetingId eq '1234567890'"). subject and VideoTeleconferenceId are NOT supported here. If you already know the meeting id, prefer MICROSOFT_TEAMS_USERS_GET_ONLINE_MEETING. There is no Graph API for free-text searching a user's meetings by title.

• List user's associated teams

  Tool to list teams that a user is associated with in Microsoft Teams. Use when you need to get teams where a user is either a direct member or a member of a shared channel hosted in the team.

• List users

  Tool to list all users in the organization. Use when you need to retrieve directory users with filtering, pagination, and field selection.

• Mark chat as read for user

  Tool to mark a chat as read for a specific user in Microsoft Teams. Use when you need to update the read status of a chat for a particular user.

• Mark chat as unread for user

  Marks a specific chat as unread for a user by setting the last read message timestamp. Use when you need to mark messages after a certain time as unread.

• Pin message in chat

  Tool to pin a message in a Microsoft Teams chat. Use when you need to highlight an important message for quick access.

• Provision channel email address

  Tool to provision an email address for a Microsoft Teams channel. Use when you need to enable email integration for a specific channel.

• Reply to Teams channel message

  Sends a reply to an existing message, identified by `message_id`, within a specific `channel_id` of a given `team_id` in Microsoft Teams.

• Reply to Teams channel message

  (DEPRECATED: use `MICROSOFT_TEAMS_POST_MESSAGE_REPLY`) Sends a reply to an existing message, identified by `message_id`, within a specific `channel_id` of a given `team_id` in Microsoft Teams.

• Send Activity Notification to Recipients

  Tool to send activity notifications to specified recipients in Microsoft Teams. Use when you need to send custom notifications to users, team members, or channel members.

• Send Channel Message

  Posts a new top-level message to a channel in Microsoft Teams (does NOT reply to an existing message). Despite the file name 'reply_to_channel_chat', this action creates a brand-new message in the channel via POST /teams/{id}/channels/{id}/messages. To reply to an existing message thread, use the dedicated reply action instead.

• Send message to Teams chat

  Sends a non-empty message (text or HTML) to a specified, existing Microsoft Teams chat; content must be valid HTML if `content_type` is 'html'.

• Set Presence Automatic Location

  Tool to set the automatic presence location (office/remote/timeOff) for a specified user. Use when updating work location status in Microsoft Teams via automatic detection.

• Set User Presence Manual Location

  Tool to set the manual presence location (office/remote/timeOff) for a specific user. Use when updating work location status for a user in Microsoft Teams.

• Share Team Schedule

  Tool to share a Microsoft Teams schedule for a specified time range. Use when you need to make a team's schedule visible to members.

• Unhide Chat For User

  Tool to unhide a chat for a specific user. Use when you need to make a hidden chat visible again in the user's chat list.

• Update Call

  Tool to update the navigation property calls in Microsoft Teams communications. Use when you need to modify properties of an existing call.

• Update Call Participant

  Tool to update a participant in a Microsoft Teams call. Use when you need to modify participant properties such as lobby status.

• Update Content Sharing Session

  Tool to update a content sharing session in a Microsoft Teams call. Use when you need to modify the properties of an existing content sharing session.

• Update online meeting

  Tool to update the properties of an existing Microsoft Teams online meeting. Use when you need to modify meeting details such as subject, start time, or end time.

• Update schedule day note

  Tool to update an existing day note in a team's schedule. Use when you need to modify notes or reminders for a specific date in the team schedule.

• Update scheduling group

  Tool to replace/update a scheduling group in a team's schedule. Use when you need to modify properties of an existing scheduling group such as display name, active status, code, or member list.