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:
| Field | Type | Required | Description |
|---|---|---|---|
timestamp | number | Yes | Unix timestamp in milliseconds |
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} 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 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.