Example Request & Response
curl --request GET \
--url http://api.intercom.io/news/news_items?page=1&per_page=2 \
--header 'accept: application/json' \
--header 'authorization: <Your access token>' \
--header 'content-type: application/json' \
{
"type": "list",
"pages": {
"page": 1,
"per_page": 2,
"total_pages": 13,
"type": "pages"
},
"data": [
{
"id": "26",
"type": "news-item",
"workspace_id": "tx2p130c",
"title": "20 Introducing Messenger-First Tickets!🎟",
"body": "<p>Hey there!</p>\n<p>Every customer need—from simple live chats to complex support tickets—can now start in the Messenger. 🌟</p>\n<p>The addition of tickets allows you to handle customer requests asynchronously. Chat agents can focus on replying to simple queries quickly, while other teams carry out escalations and operational tasks in the background using tickets.</p>\n<p>That means you can now resolve every customer issue entirely in Intercom.</p>\n<p><a href=\"https://www.intercom.com/help/en/articles/6436600-tickets-explained\" rel=\"nofollow noopener noreferrer\" target=\"_blank\" class=\"intercom-content-link\">Read on.</a></p>",
"sender_id": 68,
"state": "live",
"labels": [
"Feature update",
"New feature",
"Product"
],
"cover_image_url": null,
"reactions": [
"💜",
"😴",
"👎",
"🎉"
],
"deliver_silently": false,
"created_at": 1668517190,
"updated_at": 1668517268,
"newsfeed_assignments": [
{
"newsfeed_id": 3,
"published_at": 1668517174
}
]
},
{
"id": "25",
"type": "news-item",
"workspace_id": "tx2p130c",
"title": "20 Introducing Messenger-First Tickets!🎟",
"body": "<p>Hey there!</p>\n<p>Every customer need—from simple live chats to complex support tickets—can now start in the Messenger. 🌟</p>\n<p>The addition of tickets allows you to handle customer requests asynchronously. Chat agents can focus on replying to simple queries quickly, while other teams carry out escalations and operational tasks in the background using tickets.</p>\n<p>That means you can now resolve every customer issue entirely in Intercom.</p>\n<p><a href=\"https://www.intercom.com/help/en/articles/6436600-tickets-explained\" rel=\"nofollow noopener noreferrer\" target=\"_blank\" class=\"intercom-content-link\">Read on.</a></p>",
"sender_id": 68,
"state": "live",
"labels": [
"Feature update",
"New feature",
"Product"
],
"cover_image_url": null,
"reactions": [
"💜",
"😴",
"👎",
"🎉"
],
"deliver_silently": false,
"created_at": 1668517174,
"updated_at": 1668517174,
"newsfeed_assignments": [
{
"newsfeed_id": 3,
"published_at": 1668517174
}
]
}
],
"total_count": 26
}
You can fetch a list of all news items by making a GET request to https://api.intercom.io/news/news_items
.
Response
Key | Type | Description |
---|---|---|
type | String | The type of object - list . |
pages | Object | A Pages object with the information needed to paginate through News Items. |
total_count | Integer | A count of the total number of news items. |
data | Array | An array of News Items Objects |
How are the news items sorted and ordered?
News items will be returned in descending order on the created_at attribute. This means if you need to iterate through results then we'll show the most recently created news items first.