Integration Service Activities

Last updated Mar 12, 2026

Send Channel Message

Project compatibility

Windows | Cross-platform

Overview

Description	API Method	API Path
Send messages in a Microsoft Teams channel with optional SharePoint file attachments.	POST	/normalised-teams/{team_id}/channels/{channel_id}/messages-v2/drive/items

Input

Parameter	Description	Data Type
Team ID	Unique identifier of the team. Enter the name of the team to retrieve it from the available drop-down list or type in a custom team ID. You can retrieve the ID from the output of the Get Team by Name activity.	string
Channel ID	Unique identifier of the channel. Enter the name of the channel to retrieve it from the available drop-down list or type a channel ID. You can retrieve the ID from the output of the Get Channel by Name activity.	string
Message body	Text content of the message	string
Adaptive card JSON	JSON payload representing the adaptive card content. Replace \" with ' and remove all the escape characters that contain '\', such as \n, \r. For example, replace \r\n\"type\" with 'type'. For details, refer to the Microsoft Teams API documentation and Adaptive cards documentation.	string
Image	Image attachment to include in the message	file
File IDs (up to 20 files)	One or more SharePoint file IDs to attach to the message. You can retrieve this ID from the output of Get File or Folder or Upload Files (Microsoft 365 activities). This field supports String type input.	string array
Mentions ID	Index of the mentioned entity in the message, a numeric identifier linking `<at>` tags in message text to mention entries. Must match the `id` attribute in the HTML `<at>` tag. Possible values: `0`, `1`, `2`, etc.	int32
Mentions mentioned user identity type	Identity type of the mentioned user. Common values: `member`, `aadUser`, `onPremiseAadUser`, `guest`. Default value for regular team members is `member`.	string
Mentions mentioned user ID	Unique identifier of the mentioned user (AAD user's unique identifier). For example `74a49af0-e4a2-43d6-9d83-52f5f0`.	string
Mentions mentioned user display name	Full display name of the mentioned user from Azure AD. For example `John Doe`	string
Mentions mention text	Text used to mention the user in the message. Should match text between `<at>` tags. For example `John Doe`.	string

Output

Parameter	Description	Data Type
Message ID	Unique identifier of the sent message	string
Web URL	Web URL of the sent message	string
Message	Full channel message object returned by the API	Object

Note:

In API workflows, a single response object is returned as the output. Any required fields can be extracted directly from this object.
In RPA workflows, some output parameters may differ, but the necessary values can still be retrieved from the response object even if they are not explicitly exposed.

Using User Mentions

To mention a user in your Teams channel message, you must configure both the message text and mentions properties.

Note: Mentioning tags is currently not supported, you can only mention users.

Format the message text.
Include the mention using HTML <at> tags with an id attribute:
```
"Hello <at id=\"0\">John Doe</at>, please review this.""Hello <at id=\"0\">John Doe</at>, please review this."
```

Configure mentions properties as in the following table.

Property	Value	Description
Mentions ID	0	Numeric identifier (increment for multiple mentions)
Mentions mention text	John Doe	Display name shown in the mention
Mentions mentioned user display name	John Doe	User's full name from Azure AD
Mentions mentioned user ID	{AAD Object ID}	User's Azure AD Object ID (see below)
Mentions mentioned user identity Type	member	Identity type (member/aadUser/guest)

To obtain the Azure AD Object ID:

Azure Portal - Navigate to Azure Active Directory > Users > {User}> Copy Object ID.
Microsoft Graph API - GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}
PowerShell - Get-AzureADUser -ObjectId "user@domain.com" | Select ObjectId

Example configuration to mention the user "Jane Smith":

Message text: "Task completed <at id=\"0\">Jane Smith</at>"
Mentions ID: 0
Mentions mention text: "Jane Smith"
Mentions mentioned user display name: "Jane Smith"
Mentions mentioned user ID: "ef1c916a-3135-4417-ba27-8eb7bd084193"
Mentions mentioned user identity Type: "member"

Note:

Only one user can be mentioned per activity instance.
The id in the <at> tag must match the Mentions ID property.
Incorrect Azure AD Object ID will cause the mention to fail.
Ensure your bot/app has permissions to mention users in the channel.

On this page

Project compatibility
Overview
Input
Output
Using User Mentions

Was this page helpful?

PREVIOUSSend Bot Direct Message

NEXTSend Group Chat Message