Force.com Actions Developer's Guide

Introducing Actions
Action Objects
Apex Actions
Email Alert Actions
Flow Actions
Post to Chatter Actions
Quick Actions
Refresh Metric Actions
Simple Email Actions
Submit for Approval Actions
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Post to Chatter Actions

Post to the feed for a specific record, user, or Chatter group.

Use a Post to Chatter action to post a message at run time to a specified feed. Post to Chatter supports @mentions and topics, but only text posts are supported.

This object is available in API version 32.0 and later.

Supported REST HTTP Methods

URI
Get a list of available post to Chatter actions:
/vXX.X/actions/standard/chatterPost
Formats
JSON, XML
HTTP Methods
GET, HEAD, POST
Authentication
Authorization: Bearer token

Inputs

Input Details
subjectNameOrId
Type
string
Description
Required. Reference to the user, Chatter group, or record whose feed you want to post to.
  • To post to a user’s feed, enter the user’s ID or Username. For example: jsmith@salesforce.com
  • To post to a Chatter group, enter the group’s Name or ID. For example: Entire Organization
  • To post to a record, enter the record’s ID. For example: 001D000000JWBDx
text
Type
string
Description
Required. The text that you want to post. Must be a string of no more than 5000 characters.

To mention a user or group, enter @[reference], where reference is the ID for the user or group that you want to mention. The reference can be a literal value, a merge field, or a flow resource.

To add a topic, enter #[string], where string is the topic that you want to add.

For example, the string Hi @[005000000000001] check this out #[some_topic]. is stored appropriately as Hi @Joe, check this out #some_topic. where “@Joe” and “#some_topic” are links to the user and topic, respectively.
type
Type
picklist
Description
Required only if subjectNameOrId is set to a user name or a Chatter group name. The type of feed that you want to post to.
  • User—Enter this value if subjectNameOrId is set to a user’s Username.
  • Group—Enter this value if subjectNameOrId is set to a Chatter group’s Name.

Outputs

Output Details
feedItemId
Type
reference
Description
The ID of the new Chatter feed item.