User Messages, General

POST {{_endpoint}}/services/data/v{{version}}/chatter/users/me/messages?text=This is a private message&recipients=<USER1_ID>,<USER2_ID>

Returns all the messages for all the private conversations for the context user. Also used to search across all messages and post a message. To return all private conversations for the context user, see User Conversations, General.

https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_users_messages_general.htm

Request Params

KeyDatatypeRequiredDescription
textstring
inReplyTostringID of an existing message that identifies which conversation this message is part of. Specify either recipients or inReplyTo. Specify one or the other, not both.
recipientsstringComma-separated list of User IDs

RESPONSES

status: Created

{&quot;body&quot;:{&quot;isRichText&quot;:null,&quot;messageSegments&quot;:[],&quot;text&quot;:&quot;This is a private message&quot;},&quot;conversationId&quot;:&quot;03M...&quot;,&quot;conversationUrl&quot;:&quot;/services/data/v58.0/chatter/users/me/conversations/03M...&quot;,&quot;id&quot;:&quot;03J...&quot;,&quot;recipients&quot;:[{&quot;additionalLabel&quot;:null,&quot;communityNickname&quot;:&quot;automatedprocess&quot;,&quot;companyName&quot;:&quot;Salesforce&quot;,&quot;displayName&quot;:&quot;Automated Process&quot;,&quot;firstName&quot;:&quot;Automated&quot;,&quot;id&quot;:&quot;005...&quot;,&quot;isActive&quot;:true,&quot;isInThisCommunity&quot;:true,&quot;lastName&quot;:&quot;Process&quot;,&quot;motif&quot;:{&quot;color&quot;:&quot;1B96FF&quot;,&quot;largeIconUrl&quot;:&quot;/img/icon/profile64.png&quot;,&quot;mediumIconUrl&quot;:&quot;/img/icon/profile32.png&quot;,&quot;smallIconUrl&quot;:&quot;/img/icon/profile16.png&quot;,&quot;svgIconUrl&quot;:null},&quot;mySubscription&quot;:null,&quot;name&quot;:&quot;Automated Process&quot;,&quot;outOfOffice&quot;:{&quot;message&quot;:&quot;&quot;},&quot;photo&quot;:{&quot;fullEmailPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/img/userprofile/default_profile_200_v2.png?fromEmail=1&quot;,&quot;largePhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/profilephoto/005/F&quot;,&quot;mediumPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/profilephoto/005/M&quot;,&quot;photoVersionId&quot;:null,&quot;smallPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/profilephoto/005/T&quot;,&quot;standardEmailPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/img/userprofile/default_profile_45_v2.png?fromEmail=1&quot;,&quot;url&quot;:&quot;/services/data/v58.0/connect/user-profiles/005.../photo&quot;},&quot;reputation&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;User&quot;,&quot;url&quot;:&quot;/services/data/v58.0/chatter/users/005...&quot;,&quot;userType&quot;:&quot;System&quot;},{&quot;additionalLabel&quot;:null,&quot;communityNickname&quot;:&quot;User1696423780773910041&quot;,&quot;companyName&quot;:&quot;Salesforce&quot;,&quot;displayName&quot;:&quot;Name&quot;,&quot;firstName&quot;:&quot;FirstName&quot;,&quot;id&quot;:&quot;005...&quot;,&quot;isActive&quot;:true,&quot;isInThisCommunity&quot;:true,&quot;lastName&quot;:&quot;Name&quot;,&quot;motif&quot;:{&quot;color&quot;:&quot;1B96FF&quot;,&quot;largeIconUrl&quot;:&quot;/img/icon/profile64.png&quot;,&quot;mediumIconUrl&quot;:&quot;/img/icon/profile32.png&quot;,&quot;smallIconUrl&quot;:&quot;/img/icon/profile16.png&quot;,&quot;svgIconUrl&quot;:null},&quot;mySubscription&quot;:null,&quot;name&quot;:&quot;Name&quot;,&quot;outOfOffice&quot;:{&quot;message&quot;:&quot;&quot;},&quot;photo&quot;:{&quot;fullEmailPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0IogXzXAXaYKJnuWCNQmXymRq?fromEmail=1&quot;,&quot;largePhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/profilephoto/729.../F&quot;,&quot;mediumPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/profilephoto/729.../M&quot;,&quot;photoVersionId&quot;:&quot;729...&quot;,&quot;smallPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/profilephoto/729.../T&quot;,&quot;standardEmailPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0Ioi-dtynkoFWsl46as__TDFU?fromEmail=1&quot;,&quot;url&quot;:&quot;/services/data/v58.0/connect/user-profiles/005.../photo&quot;},&quot;reputation&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;User&quot;,&quot;url&quot;:&quot;/services/data/v58.0/chatter/users/005...&quot;,&quot;userType&quot;:&quot;Internal&quot;}],&quot;sender&quot;:{&quot;additionalLabel&quot;:null,&quot;communityNickname&quot;:&quot;User1696423780773910041&quot;,&quot;companyName&quot;:&quot;Salesforce&quot;,&quot;displayName&quot;:&quot;Name&quot;,&quot;firstName&quot;:&quot;Firstname&quot;,&quot;id&quot;:&quot;005...&quot;,&quot;isActive&quot;:true,&quot;isInThisCommunity&quot;:true,&quot;lastName&quot;:&quot;Name&quot;,&quot;motif&quot;:{&quot;color&quot;:&quot;1B96FF&quot;,&quot;largeIconUrl&quot;:&quot;/img/icon/profile64.png&quot;,&quot;mediumIconUrl&quot;:&quot;/img/icon/profile32.png&quot;,&quot;smallIconUrl&quot;:&quot;/img/icon/profile16.png&quot;,&quot;svgIconUrl&quot;:null},&quot;mySubscription&quot;:null,&quot;name&quot;:&quot;Name&quot;,&quot;outOfOffice&quot;:{&quot;message&quot;:&quot;&quot;},&quot;photo&quot;:{&quot;fullEmailPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0IogXzXAXaYKJnuWCNQmXymRq?fromEmail=1&quot;,&quot;largePhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/profilephoto/729.../F&quot;,&quot;mediumPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/profilephoto/729.../M&quot;,&quot;photoVersionId&quot;:&quot;729...&quot;,&quot;smallPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/profilephoto/729.../T&quot;,&quot;standardEmailPhotoUrl&quot;:&quot;https://\u003cmy_domain\u003e/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0Ioi-dtynkoFWsl46as__TDFU?fromEmail=1&quot;,&quot;url&quot;:&quot;/services/data/v58.0/connect/user-profiles/005.../photo&quot;},&quot;reputation&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;User&quot;,&quot;url&quot;:&quot;/services/data/v58.0/chatter/users/005...&quot;,&quot;userType&quot;:&quot;Internal&quot;},&quot;sendingCommunity&quot;:null,&quot;sentDate&quot;:&quot;\u003cdatetime\u003e&quot;,&quot;url&quot;:&quot;/services/data/v58.0/chatter/users/me/messages/03J...&quot;}