API ReferenceBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

List all news items

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

KeyTypeDescription
typeStringThe type of object - list.
pagesObjectA Pages object with the information needed to paginate through News Items.
total_countIntegerA count of the total number of news items.
dataArrayAn 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.