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

Create a news item

You can create a news item by making a POST request to http://api.intercom.io/news/news_items

Request Body Parameters

KeyTypeRequiredDescription
titleStringYesThe title of the news item.
bodyStringNoSee more on what we accept in the Supported HTML table below.
sender_idYesStringThe id of the sender of the news item. Must be a teammate on the workspace.
stateStringNoEither "live" or "draft".
News items will not be visible to your users in the assigned newsfeeds until they are set live.
newsfeed_assignmentsNewsfeed Assignment Object[]NoList of newsfeed assignments to assign to the specified newsfeed. See Newsfeed Assignment Object
labelsString[]NoLabel names displayed to users to categorize the news item.
cover_image_urlURLNoURL of the image used as cover. Must have .jpg or .png extension
reactionsString[]NoOrdered list of emoji reactions to the news item. When empty, reactions are disabled
deliver_silentlybooleanNoWhen set to true, the news item will appear in the messenger newsfeed without showing a notification badge.
Example Request & Response

curl --request POST \
  --url http://api.intercom.io/news/news_items \
  --header 'accept: application/json' \
  --header 'authorization: <Your access token>' \
  --header 'content-type: application/json' \
  --data '{"title": "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"],"reactions": ["💜","😴","👎","🎉"],"deliver_silently": false,"created_at": "2022-11-10 13:25:55 UTC","updated_at": "2022-11-10 15:12:42 UTC","newsfeed_assignments": [{"newsfeed_id": 5},{"newsfeed_id": 4}]}'
{

  "id": "24",
  "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": 1668515591,
  "updated_at": 1668515591,
  "newsfeed_assignments": [

    {
      "newsfeed_id": 3,
      "published_at": 1668515593
    }
  ]
}