Team
Shared credential for production and unattended runs.
Connect Microsoft Teams with Hookshot™ and your stack
Microsoft Teams integrates chat, video meetings, and file storage within Microsoft 365, providing virtual collaboration and communication for distributed teams
Tools and triggers
What Agents can do in Microsoft Teams
Available tools and events after Microsoft Teams is connected.
-
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
This action adds a specified user to an existing Microsoft Teams team. Leave roles empty for a standard member, use "owner" for owners, or use "guest" for guests. Guest adds require delegated permissions and the guest…
-
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.
-
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
This action archives a specified Microsoft Teams team by its ID. It also allows setting the SharePoint site to read-only for team members during the archiving process.
-
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…
-
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…
-
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…
-
Create a Channel
This action creates a new channel in a specified Microsoft Teams team. Users can define the channel's name, description, and membership type during creation.
-
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 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 Chat
This action creates a new chat in Microsoft Teams, either as a one-on-one or group chat. If a one-on-one chat already exists with the specified members, it retrieves the details of that chat instead. IMPORTANT: The…
-
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 Online Meeting
This action schedules a new standalone Microsoft Teams online meeting. It allows users to specify meeting details such as the timing, subject, external ID, associated chat information, participants, passcode…
-
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 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 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…
-
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…
-
Create Team
This action creates a new team in Microsoft Teams. It provisions the team with a name, optional template, channels, and specified 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.
-
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.
-
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
This action deletes a specified Microsoft Teams team using its unique identifier. Ensure that the team ID is correct, as this action is irreversible.
-
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 All Chats
This action lists the chats associated with a specific user in Microsoft Teams, one page at a time, with property selection and filtering. An unfiltered first page for the current user includes their self-chat…
-
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 Chat Message
Retrieves a specific chat message from a Microsoft Teams chat. You need to provide the chat ID and message ID to get the desired message details.
-
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 Meeting Recording Content
Retrieve up to 256 MiB of video content for a scheduled, non-expired Microsoft Teams meeting recording as a downloadable file. Use this after listing recordings. For delegated connections, Microsoft Graph allows the…
-
Get Meeting Transcript Content
Retrieve the raw content for a Microsoft Teams meeting transcript, with or without speaker attribution. Use this after listing meeting transcripts and selecting a transcript ID. The Microsoft Graph transcript APIs only…
-
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 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 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
Fetches details of a Microsoft Teams team using its unique ID. This action provides essential information about the team, including settings and visibility status.
-
Get Team Channel
Fetches details of a specific Microsoft Teams channel based on the provided team and channel identifiers. This action ensures you have accurate and current information about the channel's properties.
-
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 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…
-
Get Teams Channel Message
This action retrieves a specific message from a Microsoft Teams channel. It requires the Team ID, Channel ID, and Message ID to locate the message within the specified channel.
-
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 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 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 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…
-
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…
-
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 Messages
This action retrieves messages from a specified Microsoft Teams channel, enabling users to read channel conversation history without needing a chat_id. It returns message IDs that can be used with other tools to fetch…
-
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 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 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 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 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 Meeting Recordings
List recordings for a scheduled, non-expired Microsoft Teams online meeting. Returns recording metadata, including IDs needed by the recording-content action. Microsoft Graph excludes live events and documents that…
-
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…
-
List Messages to Yourself
List one page from your Microsoft Teams self-DM (the chat with yourself), so you can read personal notes without looking up any chat or user ID.
-
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
This action allows you to retrieve a list of people relevant to a specified user from Microsoft Graph. It can provide information such as names and email addresses, depending on the search parameters entered.
-
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
This action retrieves a list of channels from a specified Microsoft Teams team. It allows options for including shared channels, applying filters, and selecting specific channel 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 Members
This action retrieves the members of a specified Microsoft Teams team. It can be used for auditing purposes or to notify users about team membership changes.
-
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 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
This action retrieves a list of Microsoft Teams that the authenticated user has access to. Users can filter the results and choose specific properties to return, making it easier to manage and navigate team information.
-
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…
-
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…
-
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 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.
-
List Users
This action fetches a list of users from the organization through the Microsoft Graph API. It allows filtering, selecting specific fields, and pagination of the results.
-
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.
-
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.
-
Reply to Teams Channel Message
This action allows users to send a reply to an existing message in a Microsoft Teams channel. Users need to provide the team, channel, and message identifiers to successfully post the reply. To @mention a person so…
-
Search Teams Files
This action searches for files across all Microsoft Teams and channels using KQL (Keyword Query Language). Build queries to find files by name, type (pdf, docx, xlsx), content, author, or modification date. Searches…
-
Search Teams Messages
This action searches for messages across all Microsoft Teams chats and channels using KQL (Keyword Query Language), including matching self-DM/personal-note messages identified by resource `chatId='48:notes'`. Use…
-
Send a Message to Yourself
Send a message to your Microsoft Teams self-DM (the chat with yourself), useful for saving a personal note without looking up any chat or user ID.
-
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
This action sends a new top-level message to a specified channel in a Microsoft Teams team. It does NOT reply to an existing message thread. Users can send content in plain text or HTML format. To @mention a person so…
-
Send Message to Teams Chat
This action sends a message to a specified Microsoft Teams chat. The message can be plain text or HTML formatted, depending on the content type specified.
-
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…
-
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 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…
-
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.
-
Soft-Delete Teams Channel Message
This action soft-deletes a message in a Microsoft Teams channel. Soft-deleted messages are hidden from users but can be recovered by administrators.
-
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
This action unarchives a Microsoft Teams team, restoring it to active status. You need to provide the unique identifier of the team you wish to unarchive.
-
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.
-
Unpin Chat Message
Tool to unpin a message from a Microsoft Teams chat. Use when you need to remove a pinned message.
-
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 Operation
Tool to update the navigation property operations in communications. Use when you need to modify properties of an existing call operation.
-
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 Chat
This action updates the properties of a Microsoft Teams chat. It allows you to modify settings such as the chat's topic. Note that only group chats can have their topics updated; one-on-one chats don't support topic…
-
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 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 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.
-
Update Team
This action updates the properties of a Microsoft Teams team. It allows you to modify settings related to team members, messaging capabilities, and fun features.
-
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
This action updates an existing message in a Microsoft Teams channel. It requires the unique identifiers for the team, channel, and message to specify which message to modify.
-
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
This action updates a specific message in a Microsoft Teams chat. It allows users to change the content of a previously sent message, ensuring that information remains accurate and up to date.
-
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.
Setup
Connect Microsoft Teams in Hookshot™
Pick a scope, then confirm what can start a Protege and what it can do.
Trigger Access
What can start a Protege from this app.
Tool Access
What a Protege can do after it starts.
Connection scope
Prefer team for production.
Personal
Tied to one user—only when the workflow needs their account.
Chat
Team-scoped for supported chat surfaces.
Build with us
See Hookshot™ in your stack.
Request early access or book a live walkthrough with the team.
