news.item.added

A new article was added to a news feed.

Delivery Metadata

Field	Value
Scope	feed
Feed type	news
Source	/feeds/news/{feedId}
Subject	The news feed item id.

Event Data Schema

The data field in the event payload contains the following structure:

Field	Type	Required	Description
feedId	string (uuid)	Yes	ID of the news feed that was updated
id	string (uuid)	Yes	ID of the news feed item that was added. Use with [`GET /feeds/news/{feedId}/items/{id}`](/docs/news-feeds/api-reference#get-a-single-feed-item) to fetch the full item.
newsPageId	string (uuid)	Yes	ID of the underlying news article. Same value across every feed that contains this article — use it to correlate items across feeds.

Example Payload

Complete example of a CloudEvents-formatted event payload for this event type. The id field is the envelope identifier — stable across retries; use it as your idempotency key.

{
  "specversion": "1.0",
  "type": "news.item.added",
  "source": "/feeds/news/{feedId}",
  "subject": "123e4567-e89b-12d3-a456-426614174000",
  "id": "456e7890-a12b-34c5-d678-901234567890",
  "time": "2024-01-15T10:30:00.000Z",
  "datacontenttype": "application/json",
  "data": {
    "feedId": "123e4567-e89b-12d3-a456-426614174000",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "newsPageId": "123e4567-e89b-12d3-a456-426614174000"
  }
}