Following

Returns a list of people, groups, records, topics, and files that the specified user is following. Also used to follow records.

You can't use the users resource to add a user to a group. Use the groups resource instead.

Note

Resource
/chatter/users/userId/following
/connect/communities/communityId/chatter/users/userId/following
Available since version
23.0
Following topics is available since version 29.0.
Requires Chatter
Yes
HTTP methods
GET, POST, or HEAD
Request parameters for GET
All parameters are optional.
Parameter Name Type Description
filterType String Specifies the key prefix to filter the type of objects returned. The key prefix is the three-character prefix code in the object ID. Object IDs are prefixed with three-character codes that specify the type of the object. For example, User objects have a prefix of 005 and Group objects have a prefix of 0F9.

Use the List of Filter Feed URLs to see the available key prefixes.

page Integer Specifies the page number to return. The default value is 0, which returns the first page.
pageSize Integer Specifies the number of items per page. Valid values are between 1 and 1000. If you don't specify a size, the default is 25.
Response body for GET
Following Page
Example for getting a list of records a user follows
/services/data/v64.0/chatter/users/005D0000001GLowIAB/following?page=1
Request body for POST
Root XML tag
<following>
Properties
Name Type Description Available Version
subjectId String The ID of the record you want to follow, such as a user ID or file ID.

Use Group Member Input for adding members to groups.

Note

23.0

Topic IDs are available in 29.0

Request parameter for POST
Parameter Name Type Description Available
subjectId String The ID of the record you want to follow, such as a user ID or file ID. 23.0

Topic IDs are available in 29.0

Response body for POST
Subscription
Example for following a record using the request body
{ "subjectId" : "001D000000Iyu2p" }
Example for following a record using parameters
/services/data/v64.0/chatter/users/me/following?subjectId=001D000000Iyu2p