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.

Use an announcement to highlight information. Users can discuss, like, and post comments on announcements in the group feed. Group members receive an email notification when you post an announcement, same as for other posts, depending on their selected group email notification frequency. Deleting the feed post deletes the announcement.

This image of Salesforce shows an announcement displayed in yellow. Creating an announcement also creates a feed item with the announcement text, which you can also see in the image. Announcement in the Salesforce UI

To post an announcement to a group, or to get information about all the announcements in a group, use the Group Announcements resource (/chatter/groups/groupId/announcements).

Resource

1/chatter/announcements/announcementId

Available since version

31.0

Requires Chatter

Yes

HTTP methods

GET, PATCH, DELETE, HEAD

Request parameters for PATCH

Parameter Name	Value	Description	Required or Optional	Available Version
`expirationDate`	Date	The Salesforce UI displays an announcement until 11:59 p.m. on this date unless another announcement is posted first. The Salesforce UI ignores the time value in the `expirationDate`. However, you can use the time value to create your own display logic in your own UI.	Required	31.0

Response for GET, PATCH

Announcement

Response for DELETE

HTTP Status Code 204

Chatter REST API Developer's Guide

No Results

Announcements Resource