Chatter REST API Developer's Guide
jSummer '26 (API version 67.0)
Spring '26 (API version 66.0)
Winter '26 (API version 65.0)
Summer '25 (API version 64.0)
Spring '25 (API version 63.0)
Winter '25 (API version 62.0)
Summer '24 (API version 61.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Summer '18 (API version 43.0)
Spring '18 (API version 42.0)
Winter '18 (API version 41.0)
Summer '17 (API version 40.0)
Spring '17 (API version 39.0)
Winter '17 (API version 38.0)
Summer '16 (API version 37.0)
Spring '16 (API version 36.0)
Winter '16 (API version 35.0)
Summer '15 (API version 34.0)
Spring '15 (API version 33.0)
Winter '15 (API version 32.0)
Spring '14 (API version 30.0)
Announcements Resource
Batch Resource
Chatter Resource
Comments Resources
Communities Resources
Communities Moderation Resources
Connect Resources
Dashboard Component Snapshot Resource
Folders Resources
Influence Resource
Likes Resource
Motifs Resources
Push Notifications Resource
Question and Answers Suggestions Resource
Subscriptions Resource
Newer Version Available
Chatter REST API Resources
This chapter contains the Chatter REST API resources. REST resources are sometimes called endpoints.
-
Action Links Resources
An action link is a button on a feed element. Clicking an action link can take a user to a Web page, initiate a file download, or invoke an API call to Salesforce or to an external server. An action link includes a URL and an HTTP method, and can include a request body and header information, such as an OAuth token for authentication. Use action links to integrate Salesforce and third-party services into the feed so that users can take action to drive productivity and accelerate innovation. -
Announcements Resource
Information about an announcement. Get information or update the expiration date of an existing announcement. An announcement displays in a designated location in the Salesforce UI until 11:59 p.m. on its expiration date, unless it’s deleted or replaced by another announcement. -
Async Query Resources
Submit SOQL queries to be processed asynchronously and check on their status. Use async query resources to make consistent SOQL queries, no matter what size the data is or where the data is stored. -
Batch Resource
Create a request body with a batch of up to 25 subrequests and send them to the server in a single request to improve your application’s performance. The response bodies and HTTP statuses for each subrequest in the batch are returned within a single response body. Each subrequest counts against rate limits. -
Chatter Resource
A directory of Chatter feeds, groups, and users resources. -
Comments Resources
Get information about, edit, like, or delete a comment. Determine whether the context user can edit a comment. -
Communities Resources
Information about the communities available to the context user, or information about a specific community. -
Communities Moderation Resources
Information about whether a user has flagged a feed element, comment, or file as inappropriate. Also used to delete flags. -
Connect Resources
Information about the context user’s organization and settings, and information about the communities the context user is a member of. -
Dashboard Component Snapshot Resource
A snapshot of a dashboard component. -
Datacloud Resources
Information about Datacloud resources used to purchase Data.com contacts or companies. Use the Datacloud resources to purchase Data.com contacts or companies and get information about your purchases, including how many credits are available for your use. -
Feed Elements Resources
Information about feed elements. Access, edit, post, search, and delete feed elements. Access a feed element’s capabilities, including bundles and their feed elements. -
Feed Items Resources
Information about feed items. Access, search, delete, bookmark, and like feed items. Access and post comments. Access and vote in polls. And access, add, and remove topics. -
Feeds Resources
Feeds are made up of feed items. There are many feed types. Each feed type has an algorithm that determines which feed items it contains. -
Files Connect Repository Resources
A files connect repository is an external content repository that’s connected to Salesforce. Use these resources to get a list of repositories, to get information about a repository or a repository file, and to get the content of a repository file. Also use these resources to get information about the files and folders in a repository folder. Use these resources to get a repository’s directory entries, permissions, and permission types. Also use these resources to update a repository’s permissions. -
Files Resources
Information about files, including content, rendered version, and sharing. -
Folders Resources
Information about a folder or the contents of a folder. Modify and delete folders, add items to folders, and sync root folders. -
Groups Resources
Information about groups, such as the group's members, photo, and the groups in the organization. Create and delete a group, add members to a group, and change the group photo. -
Influence Resource
List of the percentile thresholds used to categorize an organization’s users by their influence in Chatter. -
Likes Resource
Information about the specified like. Also used to delete a like. -
Managed Topics Resources
Managed topics for a community. Get a list of managed topics. Create, delete, or reorder managed topics in a community. -
Mentions Resources
Information about users and groups that a user can mention in a feed item body or comment body. When a user or group is mentioned, they receive notification. -
Motifs Resources
Returns URLs for sets of small, medium, and large motif icons. Records have different sets of motif icons depending on the record type. The motif can also include the record type’s base color. -
Push Notifications Resource
Send a mobile push notification to connected apps on users’ devices. This resource is only accessible when the session is established with a connected app that is developed in the same organization or installed in the same package as the recipient’s connected app. -
Question and Answers Suggestions Resource
Get question and answers suggestions. -
Recommendation Audience Resources
Target specific audiences for your custom recommendations. Use these resources to get information about, create, update, and delete recommendation audiences. -
Recommendation Definition Resources
Recommendation definitions allow you to create custom recommendations that appear in communities, encouraging users to watch videos, take training and more. Use these resources to get information about, create, modify, and delete recommendation definitions. Also get information about, upload, modify, and delete recommendation definition photos. -
Records Resources
Get information about the followers of a record. Add and remove topics from records. -
Scheduled Recommendations Resources
Get information about, create, update, or delete scheduled recommendations. -
Subscriptions Resource
Information about the specified subscription. Also used to delete a subscription, for example, to unfollow a record or a topic. -
Topics Resources
List of topics for the organization, list of suggested topics for a specified string of text, feed item, or record, list of trending topics for the organization, information about a specified topic, endorsements for a specific topic, information about the files posted recently to a specified topic, information about the groups recently contributing to a specified topic, knowledgeable people for a specified topic, and list of topics related to a specified topic. -
User Profiles Resources
The user profile data populates the profile page (also called the Chatter profile page). This data includes user information (such as address, manager, and phone number), some user capabilities (permissions), and a set of subtab apps, which are custom tabs on the profile page. -
Users Resources
Information about the user, such as who is following the user, the user’s files or recommendations. Also used for posting feed items and updating conversation status. -
Zones Resources
Information about Chatter Answers zones.