Microsoft Teams

Use Microsoft Teams to read, send, update, or delete chat and channel messages, reply to threads, and add reactions. List teams, chats, channels, and their members to resolve destinations.

Switch to trigger mode to start a workflow from message notifications in a selected chat, or when the outgoing webhook is @mentioned in a channel. To mention a user, wrap the name in <at> tags, such as <at>userName</at>, and supply the mention details required by the action.

Chat subscriptions request creation and update notifications, but Sim deduplicates them by subscription and message ID within a seven-day window. Later edits may not start a separate workflow run.

OAuth scopes

Sim requests these scopes when someone connects a Microsoft Teams account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.

Use the block

Read, write, update, and delete chat and channel messages. Reply to messages, add reactions, and list teams, chats, channels, and their members. Use trigger mode for message notifications in a selected chat, or an @mention of the outgoing webhook in a channel. Chat subscriptions request creation and update notifications, but Sim deduplicates them by subscription and message ID within a seven-day window. Later edits may not start a separate run. To mention users in messages, wrap their name in <at> tags: <at>userName</at>

Actions

Read Microsoft Teams Chat

Read content from a Microsoft Teams chat

Inputs and outputs

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	Download and include message attachments (hosted contents) into storage

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)

Write to Microsoft Teams Chat

Write or update content in a Microsoft Teams chat

Inputs and outputs

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	Files to attach to the message

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

Read Microsoft Teams Channel

Read content from a Microsoft Teams channel

Inputs and outputs

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	Download and include message attachments (hosted contents) into storage

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)

Write to Microsoft Teams Channel

Write or send a message to a Microsoft Teams channel

Inputs and outputs

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	Files to attach to the message

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

Update Microsoft Teams Chat Message

Update an existing message in a Microsoft Teams chat

Inputs and outputs

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	The new content for the message (plain text or HTML formatted)

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

Update Microsoft Teams Channel Message

Update an existing message in a Microsoft Teams channel

Inputs and outputs

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	The new content for the message (plain text or HTML formatted)

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

Delete Microsoft Teams Chat Message

Soft delete a message in a Microsoft Teams chat

Inputs and outputs

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

Delete Microsoft Teams Channel Message

Soft delete a message in a Microsoft Teams channel

Inputs and outputs

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

Reply to Microsoft Teams Channel Message

Reply to an existing message in a Microsoft Teams channel

Inputs and outputs

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	The reply content (plain text or HTML formatted message)

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

Get Microsoft Teams Message

Get a specific message from a Microsoft Teams chat or channel

Inputs and outputs

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

Add Reaction to Microsoft Teams Message

Add an emoji reaction to a message in Microsoft Teams

Inputs and outputs

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	The emoji reaction (e.g., ❤️, 👍, 😊)

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

Remove Reaction from Microsoft Teams Message

Remove an emoji reaction from a message in Microsoft Teams

Inputs and outputs

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	The emoji reaction to remove (e.g., ❤️, 👍, 😊)

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

List Microsoft Teams Team Members

List all members of a Microsoft Teams team

Inputs and outputs

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

List Microsoft Teams Channel Members

List all members of a Microsoft Teams channel

Inputs and outputs

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

List Microsoft Teams Chat Members

List all members of a Microsoft Teams chat

Inputs and outputs

Input

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

Output

Parameter	Type	Description
success	boolean	Whether the listing was successful
members	array	Array of chat members
memberCount	number	Total number of members
hasMore	boolean	Whether Graph indicated additional pages beyond this response

List Microsoft Teams

List the Microsoft Teams the current user is a direct member of

Inputs and outputs

Input

Parameter	Type	Required	Description

Output

Parameter	Type	Description
success	boolean	Whether the listing was successful
teams	array	Array of teams the user is a member of
teamCount	number	Total number of teams
hasMore	boolean	Whether Graph indicated additional pages beyond this response

List Microsoft Teams Chats

List the Microsoft Teams chats the current user is part of

Inputs and outputs

Input

Parameter	Type	Required	Description

Output

Parameter	Type	Description
success	boolean	Whether the listing was successful
chats	array	Array of chats the user is part of
chatCount	number	Total number of chats
hasMore	boolean	Whether Graph indicated additional pages beyond this response

List Microsoft Teams Channels

List all channels in a Microsoft Teams team

Inputs and outputs

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
channels	array	Array of channels in the team
channelCount	number	Total number of channels
hasMore	boolean	Whether Graph indicated additional pages beyond this response

Triggers

A trigger starts a workflow when a supported event occurs in this service.

Microsoft Teams Channel

Trigger workflows when the outgoing webhook is @mentioned in a Microsoft Teams channel.

Configuration and outputs

Configuration

Parameter	Type	Required	Description
hmacSecret	string	Yes	The security token provided by Teams when creating an outgoing webhook. Used to verify request authenticity.

Output

Parameter	Type	Description
from	object
↳ id	string	Sender ID
↳ name	string	Sender name
↳ aadObjectId	string	AAD Object ID
message	object
↳ raw	object
↳ attachments	json	Array of attachments
↳ channelData	object
↳ team	object
↳ id	string	Team ID
↳ tenant	object
↳ id	string	Tenant ID
↳ channel	object
↳ id	string	Channel ID
↳ teamsTeamId	string	Teams team ID
↳ teamsChannelId	string	Teams channel ID
↳ conversation	object
↳ id	string	Composite conversation ID
↳ name	string	Conversation name (nullable)
↳ isGroup	boolean	Is group conversation
↳ tenantId	string	Tenant ID
↳ aadObjectId	string	AAD Object ID (nullable)
↳ conversationType	string	Conversation type (channel)
↳ text	string	Message text content
↳ messageType	string	Message type
↳ channelId	string	Channel ID (msteams)
↳ timestamp	string	Timestamp
activity	object	Activity payload
conversation	object
↳ id	string	Composite conversation ID
↳ name	string	Conversation name (nullable)
↳ isGroup	boolean	Is group conversation
↳ tenantId	string	Tenant ID
↳ aadObjectId	string	AAD Object ID (nullable)
↳ conversationType	string	Conversation type (channel)

Microsoft Teams Chat

Trigger workflows from Microsoft Teams chat message notifications via Microsoft Graph subscriptions. Notifications share a seven-day deduplication window keyed by subscription and message ID, so later edits may not start a separate run.

Configuration

Output