Microsoft Teams

Usage Instructions

Integrate Microsoft Teams into the workflow. Read, write, update, and delete chat and channel messages. Reply to messages, add reactions, and list team/channel members. Can be used in trigger mode to trigger a workflow when a message is sent to a chat or channel. To mention users in messages, wrap their name in <at> tags: <at>userName</at>

Tools

`microsoft_teams_read_chat`

Input

Parameter	Type	Required	Description
`chatId`	string	Yes	The ID of the chat to read from (e.g., "19:abc123def456@thread.v2" - from chat listings)
`includeAttachments`	boolean	No	No description

Output

Parameter	Type	Description
`success`	boolean	Teams chat read operation success status
`messageCount`	number	Number of messages retrieved from chat
`chatId`	string	ID of the chat that was read from
`messages`	array	Array of chat message objects
`attachmentCount`	number	Total number of attachments found
`attachmentTypes`	array	Types of attachments found
`content`	string	Formatted content of chat messages
`attachments`	file[]	Uploaded attachments for convenience (flattened)

`microsoft_teams_write_chat`

Input

Parameter	Type	Required	Description
`chatId`	string	Yes	The ID of the chat to write to (e.g., "19:abc123def456@thread.v2" - from chat listings)
`content`	string	Yes	The content to write to the message (plain text or HTML formatted, supports @mentions)
`files`	file[]	No	No description

Output

Parameter	Type	Description
`success`	boolean	Teams chat message send success status
`messageId`	string	Unique identifier for the sent message
`chatId`	string	ID of the chat where message was sent
`createdTime`	string	Timestamp when message was created
`url`	string	Web URL to the message
`updatedContent`	boolean	Whether content was successfully updated
`files`	file[]	Files attached to the message

`microsoft_teams_read_channel`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	The ID of the team to read from (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings)
`channelId`	string	Yes	The ID of the channel to read from (e.g., "19:abc123def456@thread.tacv2" - from channel listings)
`includeAttachments`	boolean	No	No description

Output

Parameter	Type	Description
`success`	boolean	Teams channel read operation success status
`messageCount`	number	Number of messages retrieved from channel
`teamId`	string	ID of the team that was read from
`channelId`	string	ID of the channel that was read from
`messages`	array	Array of channel message objects
`attachmentCount`	number	Total number of attachments found
`attachmentTypes`	array	Types of attachments found
`content`	string	Formatted content of channel messages
`attachments`	file[]	Uploaded attachments for convenience (flattened)

`microsoft_teams_write_channel`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	The ID of the team to write to (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings)
`channelId`	string	Yes	The ID of the channel to write to (e.g., "19:abc123def456@thread.tacv2" - from channel listings)
`content`	string	Yes	The content to write to the channel (plain text or HTML formatted, supports @mentions)
`files`	file[]	No	No description

Output

Parameter	Type	Description
`success`	boolean	Teams channel message send success status
`messageId`	string	Unique identifier for the sent message
`teamId`	string	ID of the team where message was sent
`channelId`	string	ID of the channel where message was sent
`createdTime`	string	Timestamp when message was created
`url`	string	Web URL to the message
`updatedContent`	boolean	Whether content was successfully updated
`files`	file[]	Files attached to the message

`microsoft_teams_update_chat_message`

Input

Parameter	Type	Required	Description
`chatId`	string	Yes	The ID of the chat containing the message (e.g., "19:abc123def456@thread.v2" - from chat listings)
`messageId`	string	Yes	The ID of the message to update (e.g., "1234567890123" - a numeric string from message responses)
`content`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the update was successful
`messageId`	string	ID of the updated message
`updatedContent`	boolean	Whether content was successfully updated

`microsoft_teams_update_channel_message`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings or channel info)
`channelId`	string	Yes	The ID of the channel containing the message (e.g., "19:abc123def456@thread.tacv2" - from channel listings)
`messageId`	string	Yes	The ID of the message to update (e.g., "1234567890123" - a numeric string from message responses)
`content`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the update was successful
`messageId`	string	ID of the updated message
`updatedContent`	boolean	Whether content was successfully updated

`microsoft_teams_delete_chat_message`

Input

Parameter	Type	Required	Description
`chatId`	string	Yes	The ID of the chat containing the message (e.g., "19:abc123def456@thread.v2" - from chat listings)
`messageId`	string	Yes	The ID of the message to delete (e.g., "1234567890123" - a numeric string from message responses)

Output

Parameter	Type	Description
`success`	boolean	Whether the deletion was successful
`deleted`	boolean	Confirmation of deletion
`messageId`	string	ID of the deleted message

`microsoft_teams_delete_channel_message`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings or channel info)
`channelId`	string	Yes	The ID of the channel containing the message (e.g., "19:abc123def456@thread.tacv2" - from channel listings)
`messageId`	string	Yes	The ID of the message to delete (e.g., "1234567890123" - a numeric string from message responses)

Output

Parameter	Type	Description
`success`	boolean	Whether the deletion was successful
`deleted`	boolean	Confirmation of deletion
`messageId`	string	ID of the deleted message

`microsoft_teams_reply_to_message`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings or channel info)
`channelId`	string	Yes	The ID of the channel (e.g., "19:abc123def456@thread.tacv2" - from channel listings)
`messageId`	string	Yes	The ID of the message to reply to (e.g., "1234567890123" - a numeric string from message responses)
`content`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the reply was successful
`messageId`	string	ID of the reply message
`updatedContent`	boolean	Whether content was successfully sent

`microsoft_teams_get_message`

Input

Parameter	Type	Required	Description
`teamId`	string	No	The ID of the team for channel messages (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID)
`channelId`	string	No	The ID of the channel for channel messages (e.g., "19:abc123def456@thread.tacv2")
`chatId`	string	No	The ID of the chat for chat messages (e.g., "19:abc123def456@thread.v2")
`messageId`	string	Yes	The ID of the message to retrieve (e.g., "1234567890123" - a numeric string from message responses)

Output

Parameter	Type	Description
`success`	boolean	Whether the retrieval was successful
`content`	string	The message content
`metadata`	object	Message metadata including sender, timestamp, etc.
↳ `messageId`	string	Message ID
↳ `content`	string	Message content
↳ `createdTime`	string	Message creation timestamp
↳ `url`	string	Web URL to the message
↳ `teamId`	string	Team ID
↳ `channelId`	string	Channel ID
↳ `chatId`	string	Chat ID
↳ `messages`	array	Array of message details
↳ `messageCount`	number	Number of messages

`microsoft_teams_set_reaction`

Input

Parameter	Type	Required	Description
`teamId`	string	No	The ID of the team for channel messages (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID)
`channelId`	string	No	The ID of the channel for channel messages (e.g., "19:abc123def456@thread.tacv2")
`chatId`	string	No	The ID of the chat for chat messages (e.g., "19:abc123def456@thread.v2")
`messageId`	string	Yes	The ID of the message to react to (e.g., "1234567890123" - a numeric string from message responses)
`reactionType`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the reaction was added successfully
`reactionType`	string	The emoji that was added
`messageId`	string	ID of the message

`microsoft_teams_unset_reaction`

Input

Parameter	Type	Required	Description
`teamId`	string	No	The ID of the team for channel messages (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID)
`channelId`	string	No	The ID of the channel for channel messages (e.g., "19:abc123def456@thread.tacv2")
`chatId`	string	No	The ID of the chat for chat messages (e.g., "19:abc123def456@thread.v2")
`messageId`	string	Yes	The ID of the message (e.g., "1234567890123" - a numeric string from message responses)
`reactionType`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the reaction was removed successfully
`reactionType`	string	The emoji that was removed
`messageId`	string	ID of the message

`microsoft_teams_list_team_members`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings)

Output

Parameter	Type	Description
`success`	boolean	Whether the listing was successful
`members`	array	Array of team members
`memberCount`	number	Total number of members

`microsoft_teams_list_channel_members`

Input

Parameter	Type	Required	Description
`teamId`	string	Yes	The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings)
`channelId`	string	Yes	The ID of the channel (e.g., "19:abc123def456@thread.tacv2" - from channel listings)

Output

Parameter	Type	Description
`success`	boolean	Whether the listing was successful
`members`	array	Array of channel members
`memberCount`	number	Total number of members

Microsoft Teams

On this page