activities
latest
false
UiPath logo, featuring letters U and I in white

Integration Service Activities

Last updated Mar 12, 2026

Send Individual Chat Message

Project compatibility

Windows | Cross-platform

Overview

DescriptionAPI MethodAPI Path
Create a private chat in Microsoft Teams with the option to attach files from SharePoint. POST/create-chat/individual-chats-messages-v2

Input

ParameterDescriptionData Type
Send byMode used to send the message (email or chat)enum
Chat ID
Unique identifier of the private chat. You can enter 48:notes to send a message to yourself.
Note: The 48:notes workaround is not officially documented by Microsoft and can be subject to change. This field supports String type input.
string
UPN (User Principal Name)User principal name of the participant. This should be the unique user login to Azure AD and other Office services. In very rare cases, the Azure AD admin can set another value for the UPN. string
User roleRole of the user in the chat (owner or member)enum
Message bodyText content of the messagestring
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
ImageImage attachment to include in the messagefile
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 IDIndex of the mentioned entity in the messageint32
Mentions mentioned user identity typeIdentity type of the mentioned userstring
Mentions mentioned user display nameDisplay name of the mentioned userstring
Mentions mentioned user IDUnique identifier of the mentioned userstring
Mentions IDIndex 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 typeIdentity type of the mentioned user. Common values: member, aadUser, onPremiseAadUser, guest. Default value for regular team members is member. string
Mentions mentioned user IDUnique identifier of the mentioned user (AAD user's unique identifier). For example 74a49af0-e4a2-43d6-9d83-52f5f0. string
Mentions mentioned user display nameFull display name of the mentioned user from Azure AD. For example John Doestring
Mentions mention textText used to mention the user in the message. Should match text between <at> tags. For example John Doe. string

Output

ParameterDescriptionData Type
Message IDUnique identifier of the sent messagestring
MessageFull chat message object returned by the APIObject
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.
  • Project compatibility
  • Overview
  • Input
  • Output

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated