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

Update a news item

Example Request & Response

curl --request PUT \
  --url http://api.intercom.io/news/news_items/65 \
  --header 'accept: application/json' \
  --header 'authorization: <Your access token>' \
  --header 'content-type: application/json' \
  --data '{"id": "65","type": "news-item","workspace_id": "tx2p130c","title": "Modified title","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": "draft","labels": ["Feature update","New feature","Product"],"cover_image_url": null,"reactions": ["💜","😴","👎","🎉"],"deliver_silently": false,"created_at": "2022-11-10 13:25:55 UTC","updated_at": "2022-11-10 13:25:55 UTC","newsfeed_assignments": [{"newsfeed_id": 5,"published_at": "2022-01-01 12:30:00 UTC"},{"newsfeed_id": 4,"published_at": "2022-01-01 12:30:00 UTC"}]}'
{

  "id": "24",
  "type": "news-item",
  "workspace_id": "tx2p130c",
  "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"
  ],
  "cover_image_url": null,
  "reactions": [

    "💜",
    "😴",
    "👎",
    "🎉"
  ],
  "deliver_silently": false,
  "created_at": 1668515591,
  "updated_at": 1668515591,
  "newsfeed_assignments": [

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

You can update the details of a single news item by making a PUT request to https://api.intercom.io/news/news_items/<id>.

Request Path Parameters

ParameterTypeRequired?Description
idStringYesThe unique identifier for the news item which is given by Intercom.

Request Body Parameters

KeyTypeRequiredDescription
titleStringYesThe title of the news item.
bodyStringNoSee more on what we accept in the Supported HTML table below.
sender_idStringYesThe 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.

Response

This will return an News Item model of the article you just updated.