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
}
]
}