Skip to main content

news.item_added

Sent when new items are added to a news feed

Event Data Schema

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

FieldTypeRequiredDescription
timestampnumberYesUnix timestamp in milliseconds
feedIdstring (uuid)YesID of the news feed that was updated
idstring (uuid)YesID of the news feed item that was added. Use with GET /feeds/news/{feedId}/items/{id} to fetch the full item.
newsPageIdstring (uuid)YesID 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 webhook payload for this event type. The top-level id is the envelope identifier — stable across retries; use it as your idempotency key. See Webhooks Overview for the full envelope schema.

{
"eventType": "news.item_added",
"timestamp": 1704123456789,
"id": "456e7890-a12b-34c5-d678-901234567890",
"data": {
"timestamp": 1704123456789,
"feedId": "987e6543-e21b-12d3-a456-426614174111"
}
}

For information about HTTP headers, security verification, and retry policies, see the Webhooks Overview.