NewsFeed

Supported Calls

delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve()

Fields

Field	Details
Body	Type textarea Properties Create, Filter, Nillable, Sort Description The content of the FeedItem. Required when Type is TextPost. Optional when Type is ContentPost or LinkPost. This is the message that appears in the feed.
CommentCount	Type int Properties Filter, Group, Sort Description The number of FeedComments associated with this feed item.
ContentData	Type base64 Properties Create, Nillable Description The file uploaded to the feed. Required if Type is ContentPost. Encoded file data. Cannot be 0 bytes. Can be any format. Setting this field automatically sets Type to ContentPost.
ContentDescription	Type textarea Properties Create, Nillable, Sort Description The description of the file specified in ContentData.
ContentFileName	Type string Properties Create, Group, Nillable, Sort Description The file uploaded to the feed. Required if Type is ContentPost. The name of the file uploaded to the feed. Setting ContentFileName automatically sets Type to ContentPost.
ContentSize	Type int Properties Group, Nillable, Sort Description Read only. Automatically determined during insert. The size of the file (in bytes) uploaded to the feed.
ContentType	Type string Properties Group, Nillable, Sort Description Read only. Automatically determined during insert. The MIME type of the file uploaded to the feed.
CreatedDate	Type dateTime Properties Defaulted on create, Filter, Sort Description Date and time when this record was created. This is a standard system field.  Ordering by CreatedDate DESC sorts the feed by the most recent feed item.
InsertedById	Type reference Properties Filter, Group, Nillable, Sort Description ID of the user who added this object to the feed. For example, if a client application migrates multiple posts and comments from another application into a feed, then InsertedById is set to the ID of the logged-in user.
IsDeleted	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the record has been moved to the Recycle Bin (true) or not (false). This is a standard system field.
LastModifiedDate	Type dateTime Properties Defaulted on create, Filter, Sort Description Date and time when this record was last modified by a user. This is a standard system field. When a feed item is created, LastModifiedDate is the same as CreatedDate. If a FeedComment is inserted on that feed item, then LastModifiedDate becomes the CreatedDate for that FeedComment. Deleting the FeedComment does not change the LastModifiedDate.  Ordering by LastModifiedDate DESC sorts the feed by both the most recent feed item or comment.
LikeCount	Type int Properties Filter, Group, Sort Description The number of FeedLikes associated with this feed item.
LinkUrl	Type url Properties Create, Filter, Nillable, Sort Description The URL of a LinkPost.
NetworkScope	Type picklist Properties Create, Filter, Group, Nillable, Sort Description Specifies whether this feed item is available in the default community, a specific community, or all communities. This field is available in API version 26.0 and later, if Salesforce Communities is enabled for your organization. NetworkScope can have the following values: NetworkId—The ID of the community in which the FeedItem is available. If left empty, the feed item is only available in the default community. AllNetworks—The feed item is available in all communities. Note the following exceptions for NetworkScope: Only feed items with a CollaborationGroup or User parent can set a NetworkId or a null value for NetworkScope. For feed items with a record parent, users can set NetworkScope only to AllNetworks.
ParentId	Type reference Properties Filter, Group, Sort Description ID of a record that is tracked in a news feed. The feed is displayed on the detail page for this record.
RelatedRecordId	Type reference Properties Create, Group, Nillable, Sort Description ID of the ContentVersion object associated with a ContentPost. This field is null for all posts except ContentPost. For example, set this field to an existing ContentVersion and post it to a feed as a FeedItem object of TypeContentPost.
Title	Type string Properties Create, Filter, Group, Nillable, Sort Description The title of the FeedItem. When the Type is LinkPost, the LinkUrl is the URL and this field is the link name.
Type	Type picklist Properties Create, Filter, Group Description The type of FeedItem: TrackedChange—a change or group of changes to a tracked field UserStatus—automatically generated when a user adds a post TextPost—a direct text entry on a feed LinkPost—a URL posting on a feed ContentPost—an uploaded file on a feed PollPost—a poll posted on a feed DashboardComponentSnapshot—a posting of a dashboard snapshot on a feed. ApprovalPost—automatically generated by a feed query on an approval item CollaborationGroupCreated—automatically generated post on a user’s feed when the user creates a public group ActivityEvent—generated event when a user or the API adds a Task associated with a feed-enabled parent record (excluding email tasks on cases) or when a user or the API adds or updates a Task or Event associated with a case record (excluding email and call logging). For a recurring Task with CaseFeed disabled, one event is generated for the series only. For a recurring Task with CaseFeed enabled, events are generated for the series and each occurrence. The following values appear in the Type picklist for all feed objects but apply only to CaseFeed: CaseCommentPost—generated event when a user adds a case comment for a case object EmailMessageEvent—generated event when an email related to a case object is sent or received CallLogPost—generated event when a user logs a call for a case through the user interface. This event is also generated by CTI calls. ChangeStatusPost—generated event when a user changes the status of a case AttachArticleEvent—generated event when a user attaches an article to a case Note If you set Type to ContentPost, you must specify ContentData and ContentFileName.
Visibility	Type picklist Properties Create, Filter, Group, Nillable, Sort Description Specifies whether this feed item is available to all users or internal users only. This field is available in API version 26.0 and later, if Salesforce Communities is enabled for your organization. Visibility can have the following values: AllUsers—The feed item is available to all users who have permission to see the feed item. InternalUsers—The feed item is available to internal users only. Note the following exceptions for Visibility: For record posts, Visibility is set to InternalUsers for all internal users by default. External users can set Visibility only to AllUsers. On user and group posts, only internal users can set Visibility to InternalUsers.

Usage

Use this object to query and retrieve record changes tracked in a news feed. Note the following when working with news feeds:

• This object is read only in the API.
• Users can only query their own news feed.
• Queries retrieve feed items that include mentions from other users.
• Use this object to query and retrieve lead feed items that were associated with a converted lead record.

Users that do not have the “View All Data” permission have the following limitations when querying records:

• Must specify a LIMIT clause and the limit must be less than or equal to 1000.
• May include a WHERE clause that references NewsFeed fields, but may not include references to fields in related objects. For example, you can filter by CreatedDate or ParentId, but not by Parent.Name.
• May include an ORDER BY clause that references NewsFeed fields, but may not include references to fields in related objects. For example, you can ORDER BYCreatedDate or ParentId, but not by Parent.Name.

Tip

To query for the most recent feed items, you should ORDER BY CreatedDate DESC, Id DESC.

Note the following SOQL restrictions.

• No SOQL limit if logged-in user has “View All Data” permission. If not, specify a LIMIT clause of 1,000 records or fewer.
• SOQL ORDER BY on fields using relationships is not available. Use ORDER BY on fields on the root object in the SOQL query.