Intercom API (unofficial showcase)
GET/news/newsfeeds/{newsfeed_id}/items

List live items in a newsfeed

Lists the live news items assigned to a specific newsfeed. Supply newsfeed_id to select the feed whose items you want to retrieve. The response includes cursor-based page metadata and a total count.

2 parameters
newsfeed_idstringrequired
The unique identifier of the newsfeed whose live items to retrieve.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted; supported values include the versions listed in the schema.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

2 status codes
200Returns a paginated response containing a total count, cursor-based page metadata, and an array of live news item objects.
typestringoptional
The type of object
Allowed:listconversation.list
pagesobjectoptional
Cursor-based pagination is a technique used in the Intercom API to navigate through large amounts of data. A "cursor" or pointer is used to keep track of the current position in the result set, allowing the API to return the data in small chunks or "pages" as needed.
total_countintegeroptional
A count of the total number of objects.
dataarray<NewsItem>optional
An array of Objects
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is unauthorized; send valid API credentials. newsfeed_id must identify the newsfeed whose live items you want to list.