NewsFeed

Represents a single feed item on a user's home tab. A Chatter feed shows recent changes to records that the user is following.

NewsFeed is available in API version 18.0 through API version 26.0. In API version 27.0 and later, NewsFeed is no longer available in the SOAP API. Use the Chatter REST API to access NewsFeed.

Supported Calls

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

Fields

Field Details
Body
Type
textarea
Properties
Nillable, Sort
Description
The content of NewsFeed. 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.
ConnectionId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
When a PartnerNetworkConnection makes a change to a record that is tracked, the CreatedBy field contains the ID of the system administrator while the ConnectionId contains the ID of the PartnerNetworkConnection that made the change. Available if Salesforce to Salesforce is enabled for your organization.
ContentData
Type
base64
Properties
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
Nillable, Sort
Description
The description of the file specified in ContentData.
ContentFileName
Type
string
Properties
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 CreatedDateDESC sorts the feed by the most recent feed item.

FeedPostId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
This field was removed in API version 22.0, and is available in earlier versions for backward compatibility only.

ID of the associated FeedPost. A FeedPost represents the following types of changes in an FeedItem: changes to tracked fields, text posts, link posts, and content posts.

InsertedById
Type
reference
Properties
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 the InsertedBy value 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
Nillable, Sort
Description
The URL of a LinkPost.
NetworkScope
Type
picklist
Properties
Group, Nillable, Restricted picklist, 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 Group 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.
  • You can’t filter a FeedItem on the NetworkScope field.
ParentId
Type
reference
Properties
Filter, Group, Sort
Description
ID of the newsfeed record that is tracked in the feed. The feed is displayed on the detail page for this record.
RelatedRecordId
Type
reference
Properties
Group, Nillable, Sort
Description
ID of the ContentVersion object associated with a ContentPost. This field is null for all posts except ContentPost.
Title
Type
string
Properties
Group, Nillable, Sort
Description
The title of the feed item. When the Type is LinkPost, the LinkUrl is the URL and this field is the link name.
Type
Type
picklist
Properties
Filter, Group, Nillable, Restricted picklist, Sort
Description
The type of feed item:
  • ActivityEvent—indirectly generated event when a user or the API adds a Task associated with a feed-enabled parent record (excluding email tasks on cases). Also occurs 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.

  • AdvancedTextPost—created when a user posts a group announcement.
  • AnnouncementPost—Not used.
  • ApprovalPost—generated when a user submits an approval.
  • BasicTemplateFeedItem—Not used.
  • CanvasPost—a post made by a canvas app posts on a feed.
  • CollaborationGroupCreated—generated when a user creates a public group.
  • CollaborationGroupUnarchived—Not used.
  • ContentPost—a post with an attached file.
  • CreatedRecordEvent—generated when a user creates a record from the publisher.
  • DashboardComponentAlert—generated when a dashboard metric or gauge exceeds a user-defined threshold.
  • DashboardComponentSnapshot—created when a user posts a dashboard snapshot on a feed.
  • LinkPost—a post with an attached URL.
  • PollPost—a poll posted on a feed.
  • ProfileSkillPost—generated when a skill is added to a user’s Chatter profile.
  • QuestionPost—generated when a user posts a question.
  • ReplyPost—generated when Chatter Answers posts a reply.
  • RypplePost—generated when a user creates a Thanks badge in Work.com.
  • TextPost—a direct text entry on a feed.
  • TrackedChange—a change or group of changes to a tracked field.
  • UserStatus—automatically generated when a user adds a post. Deprecated.
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
Filter, Group, Nillable, Restricted picklist, 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:

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

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

Note the following SOQL restrictions.

© Copyright 2000–2014 salesforce.com, inc. All rights reserved.
Various trademarks held by their respective owners.