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.

Setting	Value
Redirect URI	`<NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/microsoft-teams`
Environment variables	`MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`

Scope	Description
`openid`	Standard authentication
`profile`	Access profile information
`email`	Access email address
`User.Read`	Sign in and read your profile
`Chat.Read`	Read your Teams chat messages
`Chat.ReadWrite`	Read and write your Teams chat messages
`Chat.ReadBasic`	Read names and members of your Teams chats
`ChatMessage.Send`	Send chat messages
`Channel.ReadBasic.All`	Read channel names and descriptions
`ChannelMessage.Send`	Send channel messages
`ChannelMessage.Read.All`	Read channel messages
`ChannelMessage.ReadWrite`	Read and write channel messages
`ChannelMember.Read.All`	Read team channel members
`Group.Read.All`	Read all groups, memberships, and group content
`Group.ReadWrite.All`	Read and write all groups
`Team.ReadBasic.All`	Read team names and descriptions
`TeamMember.Read.All`	Read team members
`offline_access`	Access account when not using the application
`Files.Read`	Read OneDrive files
`Sites.Read.All`	Read documents and list items in all SharePoint sites

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

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	This trigger requires microsoft teams credentials to access your account.
`triggerChatId`	string	Yes	The ID of the Teams chat to monitor
`includeAttachments`	boolean	No	Fetch hosted contents and upload to storage

Output

Parameter	Type	Description
`message_id`	string	Message ID
`chat_id`	string	Chat ID
`from_name`	string	Sender display name
`text`	string	Message body (HTML or text)
`created_at`	string	Message timestamp
`attachments`	file[]	Uploaded attachments as files