Microsoft Teams
Overview
Section titled “Overview”Microsoft Teams is Microsoft 365’s corporate collaboration platform, bringing together chat, video calls, topic-based channels, and file storage in a single environment. With the SquadOS integration, your agents can send messages to chats and channels, create and manage teams, schedule online meetings, check user presence, and search files and messages — all automated via the Microsoft Graph API.
- Official website: https://www.microsoft.com/en-us/microsoft-teams/
- Composio documentation: docs.composio.dev/toolkits/microsoft_teams
Authentication
Section titled “Authentication”This tool uses OAuth 2.0 (OAUTH2) to connect. It also supports application authentication (S2S_OAUTH2) for server-to-server scenarios.
You will need the following fields:
| Field | Required | Description |
|---|---|---|
client_id | Yes | Application ID registered in Azure Entra ID (formerly Azure AD). |
client_secret | Yes | Client secret generated in the Azure portal for the registered application. |
tenant_id | Yes | Microsoft 365 tenant ID of your organization. |
How to get credentials
Section titled “How to get credentials”- Go to the Azure portal and sign in with an organizational admin account.
- Navigate to Azure Active Directory (or Microsoft Entra ID) → App registrations → New registration.
- Fill in the application name, select the desired account type, and set the redirect URI.
- After creating the application, copy the Application (client) ID and the Directory (tenant) ID.
- Go to Certificates & secrets → New client secret, set the expiry, and copy the generated value.
- Under API permissions, add the necessary Microsoft Graph permissions (e.g.,
Chat.ReadWrite,Channel.ReadBasic.All,Team.ReadBasic.All,Presence.Read). - Click Grant admin consent to activate the permissions.
How to connect in SquadOS
Section titled “How to connect in SquadOS”- Go to Tools in the side menu (
/admin/tools). - Open the Available tab and search for
Microsoft Teams. - Click the card to open the details modal and hit Connect.
- You’re taken to the secure connection page hosted by Composio, where you authorize access via OAuth 2.0 with your organizational Microsoft account.
- Once done, you’re sent back to SquadOS with the account connected and the tool available for your agents. (Connection-flow details in Organization Tools.)
Available actions
Section titled “Available actions”Send Channel Message
Section titled “Send Channel Message”MICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGE
Posts a new top-level message to a channel in Microsoft Teams. Use to send automated notifications, alerts, or updates to a specific channel.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | The unique identifier of the Microsoft Teams team containing the channel. |
channel_id | string | Yes | The unique identifier of the channel within the specified team where the message will be posted. |
content | string | Yes | The content of the message to be sent. Can be plain text or HTML, determined by content_type. |
content_type | string | No | The format of the message content. Defaults to text. Use html for formatted messages. |
subject | string | No | The subject of the chat message, in plaintext. |
importance | string | No | The importance of the chat message: normal, high, or urgent. Defaults to normal. |
mentions | array | No | List of entities mentioned in the chat message. Use with HTML content containing <at> tags. |
attachments | array | No | References to attached objects like files, tabs, meetings, etc. |
summary | string | No | Summary text for push notifications and summary views. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Send message to Teams chat
Section titled “Send message to Teams chat”MICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGE
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.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
chat_id | string | Yes | Unique identifier for the Microsoft Teams chat to receive the message. |
content | string | Yes | Message content, either plain text or HTML (see content_type). |
content_type | string | No | Content format: text (plain) or html. |
subject | string | No | The subject of the chat message, in plaintext. |
importance | string | No | The importance of the chat message: normal, high, or urgent. Defaults to normal. |
mentions | array | No | List of entities mentioned in the chat message. Supported entities: user, bot, team, channel, chat, and tag. |
attachments | array | No | References to attached objects like files, tabs, meetings, or cards. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Reply to Teams channel message
Section titled “Reply to Teams channel message”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.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | The unique identifier (GUID) of the Microsoft Teams team that owns/hosts the channel. For shared channels, this must be the host team ID. |
channel_id | string | Yes | The unique identifier of the channel containing the message to reply to. Standard channels use format 19:{alphanumeric}@thread.tacv2. |
message_id | string | Yes | The unique identifier of the specific message within the channel to which this reply is directed. |
content | string | Yes | The body of the reply message. Can be plain text or HTML, as specified by the content_type field. |
content_type | string | No | Specifies the format of the content field: text or html. Defaults to text. |
importance | string | No | Priority level of the reply message: normal, high, or urgent. |
mentions | array | No | List of entities mentioned in the reply. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Create Chat
Section titled “Create Chat”MICROSOFT_TEAMS_TEAMS_CREATE_CHAT
Creates a new chat. If a oneOnOne chat with the specified members already exists, its details are returned; group chats are always newly created. The authenticated user MUST be included as one of the members.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
chatType | string | Yes | Type of chat: oneOnOne (between two users) or group (multiple users). |
members | array | Yes | List of members. The authenticated user MUST be included. For oneOnOne chats, exactly two members; for group chats, at least two members with one having the owner role. |
topic | string | No | Subject or title for the chat. REQUIRED for group chats; ignored for oneOnOne. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Create Team
Section titled “Create Team”MICROSOFT_TEAMS_CREATE_TEAM
Creates a new Microsoft Teams team with optional template, channels, and members.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
displayName | string | Yes | Display name of the team as it will appear in Microsoft Teams. |
visibility | string | No | Team visibility: private (only owners can add members), public (anyone in the organization can join), or hiddenMembership. Default: public. |
description | string | No | Brief description of the team’s purpose. Maximum 1024 characters. |
members | array | No | List of initial team members. At least one member with owner role is recommended. |
channels | array | No | Collection of channels to create in the team. The General channel is created automatically. |
templateOdataBind | string | No | URL reference to the team template (e.g., standard, educationClass). |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Create a channel
Section titled “Create a channel”MICROSOFT_TEAMS_CREATE_CHANNEL
Creates a new standard, private, or shared channel within a Microsoft Teams team.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | The GUID of the existing Microsoft Teams team where the new channel will be created. |
name | string | Yes | The display name for the new channel. Maximum length is 50 characters. Cannot contain the following characters: ~ # % & * { } + / \ : < > ? | ' " , or control characters. Cannot start with an underscore or period. |
description | string | No | An optional, user-friendly description of the channel’s purpose. Maximum length is 1024 characters. |
membership_type | string | No | Membership type: standard (all team members), private (specific subset), or shared (can include people outside the team). |
is_favorite_by_default | boolean | No | Indicates whether the channel should be marked as recommended for all team members. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
List Teams
Section titled “List Teams”MICROSOFT_TEAMS_TEAMS_LIST
Retrieves Microsoft Teams accessible by the authenticated user, with support for filtering, property selection, and pagination.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
top | integer | No | Maximum number of teams to return per page (1–999). |
filter | string | No | OData v4.0 filter string to refine results (e.g., startsWith(displayName,'A')). |
select | string | No | Comma-separated team properties to retrieve (e.g., id,displayName,description). |
count | boolean | No | When true, includes the total count of items in @odata.count. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
List team channels
Section titled “List team channels”MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS
Retrieves channels for a specified Microsoft Teams team, with options to include shared channels, filter results, and select properties.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | Unique identifier (GUID/UUID) of the Microsoft Teams team. |
filter | string | No | OData v4 query string to filter channels (e.g., startswith(displayName,'Sales') or membershipType eq 'private'). |
select | string | No | Comma-separated channel properties to return (e.g., id,displayName,description). |
include_shared_channels | boolean | No | If true, include channels shared with the team. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
List channel messages
Section titled “List channel messages”MICROSOFT_TEAMS_TEAMS_LIST_CHANNEL_MESSAGES
Tool to list messages in a Teams channel when team_id and channel_id are known. Use to enumerate channel message history and obtain message_id for follow-on operations.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | Unique identifier (GUID) of the Microsoft Teams team. |
channel_id | string | Yes | Unique identifier of the channel within the team. |
top | integer | No | Maximum number of messages to return per page (1–50). Microsoft Graph enforces a maximum of 50 messages per request. |
expand | string | No | Optional expansion parameter. Only replies is supported, which includes message replies. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
List team members
Section titled “List team members”MICROSOFT_TEAMS_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.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | GUID of the Microsoft Teams team to retrieve members from. |
top | integer | No | Optional maximum number of members to request per Microsoft Graph page (1–999). |
filter | string | No | Optional OData filter expression to filter members by userId, displayName, or email. |
select | string | No | Optional comma-separated list of properties to include in the response (e.g., id,displayName,email). |
next_link | string | No | Opaque Microsoft Graph @odata.nextLink URL returned by a previous response for pagination. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Add member to team
Section titled “Add member to team”MICROSOFT_TEAMS_ADD_TEAM_MEMBER
Tool to add a user to a Microsoft Teams team. Use when granting or updating membership for a user.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | The unique ID (GUID) of the Microsoft Team to which the member will be added. |
user_id | string | Yes | The user’s Graph ID (GUID) or userPrincipalName (email) to add to the team. Guest users must be referenced by object ID. |
roles | array | No | Roles to assign to the member. Use ['owner'] for a team owner or ['guest'] for a guest. Omit or leave empty to add as a standard member. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Remove team member
Section titled “Remove team member”MICROSOFT_TEAMS_REMOVE_TEAM_MEMBER
Removes a member from a Microsoft Teams team.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | The unique identifier of the team. |
membership_id | string | Yes | The unique identifier of the team member’s membership record. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Create online meeting
Section titled “Create online meeting”MICROSOFT_TEAMS_CREATE_MEETING
Use to schedule a new standalone Microsoft Teams online meeting not linked to any calendar event.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
subject | string | Yes | The subject or title for the online meeting. |
start_date_time | string | Yes | The start date and time of the meeting in ISO 8601 format (e.g., 2024-08-15T10:00:00Z). |
end_date_time | string | Yes | The end date and time of the meeting in ISO 8601 format. Must be after start_date_time. |
user_id | string | No | The user ID on whose behalf to create the meeting. Required when using application permissions (S2S). |
participants | array | No | An optional list of participants to invite to the meeting. |
allow_recording | boolean | No | Indicates whether recording is enabled for the meeting. |
allowed_presenters | string | No | Specifies who can be a presenter: everyone (default), organization, roleIsPresenter, or organizer. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Get User Presence
Section titled “Get User Presence”MICROSOFT_TEAMS_GET_PRESENCE
Tool to get a specific user’s presence information. Use when checking availability status, activity, or work location for a particular user.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
user_id | string | Yes | The unique identifier (GUID) or user principal name (UPN) of the user. Use me to get the authenticated user’s presence. |
select | string | No | Comma-separated OData property names to include in the response (e.g., availability,activity). |
expand | string | No | Comma-separated list of relationships to expand inline (e.g., statusMessage). |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Set Presence
Section titled “Set Presence”MICROSOFT_TEAMS_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.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
user_id | string | Yes | The unique identifier (GUID) of the user whose presence session to set. |
session_id | string | Yes | The ID of the application’s presence session. Should typically match the application ID (appId) from the OAuth token. |
availability | string | Yes | The base presence information: Available, Busy, Away, or DoNotDisturb. |
activity | string | Yes | The supplemental information to availability: Available, InACall, InAConferenceCall, Away, or Presenting. |
expiration_duration | string | No | The expiration of the app presence session in ISO 8601 duration format. Valid range: PT5M to PT4H. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Search Teams messages
Section titled “Search Teams messages”MICROSOFT_TEAMS_SEARCH_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. NOTE: Requires an organizational Microsoft 365 account (Azure AD/Entra ID) — does NOT work with personal Microsoft accounts.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
query | string | No | KQL search query string. Examples: from:user@example.com AND sent>=2024-10-01, punchlist OR termination, sent>today-30 AND hasattachment:yes. Empty queries default to sent>=2020-01-01. |
size | integer | No | The maximum number of search results to return per page. |
from_index | integer | No | The 0-based starting index for pagination. |
enable_top_results | boolean | No | If true, sorts results by relevance; otherwise, sorts by date in descending order. |
region | string | No | Geographic region: NAM, EMEA, or APAC. ONLY required when using application permissions (S2S). |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Search Teams files
Section titled “Search Teams files”MICROSOFT_TEAMS_SEARCH_FILES
Search files in Microsoft Teams using KQL syntax. Find files by name, type, content, author, and modification date across all Teams and channels.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query for files in Teams. Supports keywords, filenames, and content search. Examples: filetype:pdf AND lastmodifiedtime>=2024-10-01, contract AND budget, filename:report AND author:user@example.com. |
size | integer | No | The maximum number of file results to return per page. |
from_index | integer | No | The 0-based starting index for pagination. |
region | string | No | Specifies the geographic region for the search request. ONLY required when using application permissions (S2S): NAM, EMEA, or APAC. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Get Teams channel message
Section titled “Get Teams channel message”MICROSOFT_TEAMS_GET_CHANNEL_MESSAGE
Retrieves a specific message from a Microsoft Teams channel using its Team, Channel, and Message IDs.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | ID of the Team containing the channel where the message is located. |
channel_id | string | Yes | ID of the Channel within the specified Team that contains the message. |
message_id | string | Yes | ID of the message to retrieve from the channel. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Get chat
Section titled “Get chat”MICROSOFT_TEAMS_GET_CHAT
Tool to retrieve a single chat by ID. Use when you need to get details about a specific chat.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
chat_id | string | Yes | The unique identifier of the chat to retrieve. Format: 19:abc123def456@thread.v2 for group chats or 19:user1_user2@unq.gbl.spaces for one-on-one chats. |
expand | array | No | List of related entities to expand in the response. Supported values: members and lastMessagePreview. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Get User Profile
Section titled “Get User Profile”MICROSOFT_TEAMS_GET_MY_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).
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
user_id | string | No | The user’s unique identifier (GUID) or user principal name (email). Use me for delegated auth (currently signed-in user). |
select | string | No | Comma-separated list of properties to include in the response. Default: id, userPrincipalName, mail, displayName. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
List users
Section titled “List users”MICROSOFT_TEAMS_LIST_USERS
Tool to list all users in the organization. Use when you need to retrieve directory users with filtering, pagination, and field selection.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
top | integer | No | Maximum number of users to return per page (1–999). Default is 100. |
filter | string | No | OData filter to refine results by property values (e.g., startswith(displayName,'A')). |
search | string | No | OData search query for advanced text search across user properties. Requires ConsistencyLevel: eventual. |
select | string | No | Comma-separated list of user properties to include (e.g., id,displayName,mail). |
orderby | string | No | OData orderby clause to sort results (e.g., displayName desc). |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
List user’s associated teams
Section titled “List user’s associated teams”MICROSOFT_TEAMS_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.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
user_id | string | Yes | User ID or user principal name (UPN) to query joined teams for. Use me to query the authenticated user’s joined teams. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Update Team
Section titled “Update Team”MICROSOFT_TEAMS_UPDATE_TEAM
Tool to update the properties of a team. Use when you need to modify team settings such as name, description, visibility, or member, messaging, and fun settings.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | The unique identifier (GUID) of the team to update. |
displayName | string | No | The name of the team. |
description | string | No | An optional description for the team. Maximum length: 1024 characters. |
visibility | string | No | The visibility of the team: private or public. |
memberSettings | object | No | Settings that control what members can do in the team. |
messagingSettings | object | No | Settings that control messaging capabilities in the team. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Archive Teams team
Section titled “Archive Teams team”MICROSOFT_TEAMS_ARCHIVE_TEAM
Tool to archive a Microsoft Teams team. Use after confirming the team ID; returns 202 if accepted.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | The unique identifier (GUID) of the team to archive. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Unarchive Teams team
Section titled “Unarchive Teams team”MICROSOFT_TEAMS_UNARCHIVE_TEAM
Tool to unarchive a Microsoft Teams team. Use when you need to restore an archived team to active state.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | The unique identifier (GUID) of the archived team to restore. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Add chat member
Section titled “Add chat member”MICROSOFT_TEAMS_ADD_CHAT_MEMBER
Tool to add a conversationMember to a Microsoft Teams chat. Use when adding a user to an existing chat conversation.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
chat_id | string | Yes | The unique identifier of the chat to which the member will be added. |
user_id | string | Yes | The user’s Graph ID (GUID) or userPrincipalName (email) to add to the chat. |
roles | array | No | Roles to assign to the member. Valid values are owner or guest. Leave empty to add as a standard member. |
visible_history_start_date_time | string | No | Optional. Timestamp denoting how far back a conversation’s history is shared with the conversation member. Must be in ISO 8601 format (e.g., 2021-01-01T00:00:00Z). |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Pin message in chat
Section titled “Pin message in chat”MICROSOFT_TEAMS_PIN_MESSAGE
Pins a message in a Microsoft Teams chat for easy later access.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
chat_id | string | Yes | The unique identifier of the chat where the message will be pinned. |
message_id | string | Yes | The unique identifier of the message to pin in the chat. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Get all chats
Section titled “Get all chats”MICROSOFT_TEAMS_CHATS_GET_ALL_CHATS
Retrieves all chats accessible by the authenticated user in Microsoft Teams.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
top | integer | No | Maximum number of chats to return per page. |
filter | string | No | OData filter expression to refine the chats returned. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |
Send Activity Notification to Recipients
Section titled “Send Activity Notification to Recipients”MICROSOFT_TEAMS_SEND_ACTIVITY_NOTIFICATION
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.
Input parameters
Section titled “Input parameters”| Name | Type | Required | Description |
|---|---|---|---|
activityType | string | Yes | The type of activity being notified. This should match an activity type defined in the Teams app manifest. |
topic | object | Yes | The topic of the notification, including source, value, and optional webUrl for deep linking. |
previewText | object | Yes | The preview text to display in the notification. |
recipients | array | Yes | Array of recipients who will receive the notification. Each recipient must specify an @odata.type and corresponding ID fields. |
templateParameters | array | No | Optional array of template parameters as key-value pairs for customizing the notification content. |
Output
Section titled “Output”| Name | Type | Required | Description |
|---|---|---|---|
data | string | Yes | Data from the action execution. |
error | string | No | Error if any occurred during the execution of the action. |
successful | boolean | Yes | Whether or not the action execution was successful. |