v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB
News

List all news items

You can fetch a list of all news items

get/news/news_items

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

Intercom API version.</br>By default, it's equal to the version set in the app package.

Example:2.14

Response

successful

type'list' | 'conversation.list'

The type of object

total_countinteger

A count of the total number of objects.

Example response

{
  "type": "list",
  "pages": {
    "type": "pages",
    "page": 1,
    "next": {
      "per_page": 2,
      "starting_after": "your-cursor-from-response"
    },
    "per_page": 2,
    "total_pages": 13
  },
  "total_count": 1,
  "data": [
    {
      "type": "news-item",
      "id": "141",
      "workspace_id": "t74hdn32",
      "title": "New feature: News Items",
      "body": "We are excited to announce the launch of News Items, a new content type in Intercom enabling you to announce product updates, company news, promotions, events and more with your customers.",
      "sender_id": 123,
      "state": "live",
      "newsfeed_assignments": [
        {
          "newsfeed_id": 198313,
          "published_at": 1674917488
        }
      ],
      "labels": [
        "Product Update"
      ],
      "cover_image_url": "https://example.com/cover.jpg",
      "reactions": [
        "👍"
      ],
      "deliver_silently": true,
      "created_at": 1610589632,
      "updated_at": 1610589632
    }
  ]
}