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

Key	Type	Required	Description
title	String	Yes	The title of the news item.
body	String	No	See more on what we accept in the Supported HTML table below.
sender_id	Yes	String	The id of the sender of the news item. Must be a teammate on the workspace.
state	String	No	Either "live" or "draft". News items will not be visible to your users in the assigned newsfeeds until they are set live.
newsfeed_assignments	Newsfeed Assignment Object[]	No	List of newsfeed assignments to assign to the specified newsfeed. See Newsfeed Assignment Object
labels	String[]	No	Label names displayed to users to categorize the news item.
cover_image_url	URL	No	URL of the image used as cover. Must have .jpg or .png extension
reactions	String[]	No	Ordered list of emoji reactions to the news item. When empty, reactions are disabled
deliver_silently	boolean	No	When 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
    }
  ]
}