newsfilter
Webhook events

story.created

A new story. Signed with Standard Webhooks.

Request Body

application/json
  1. body
event_id*string

Unique per event and the same on every retry. Dedupe on it.

type*string

The event type. Always story.created.

schema_version*number

Version of the event shape. Always 1.

occurred_at*string

When it happened.

Formatdate-time
origin*Origin

live for news as it arrives. Apps should not notify users for backfill events.

Value in"live""backfill""reprocess"
ticker*string

The ticker it is about.

data*

What changed, as a snapshot taken when the event was created.

Response Body

Acknowledge fast; process later

Example Requests
POST/story.created
Request Body
application/json
{  "event_id": "evt_01JC4ZQ8M6W7Y3T2K9P5R1N0BX",  "type": "story.created",  "schema_version": 1,  "occurred_at": "2026-11-03T14:05:00Z",  "origin": "live",  "ticker": "ACME",  "data": {    "story": {      "id": "st_01JC4ZQ8M6W7Y3T2K9P5R1N0BX",      "version": 1,      "ticker": "ACME",      "headline": "Acme raises full-year guidance",      "summary": "Acme raised its full-year revenue guidance to $4.2 billion, citing stronger industrial orders.",      "strong": true,      "strong_reason": "A guidance change from the company.",      "article_count": 1,      "articles": [        {          "id": "art_01JC4ZQ8M6W7Y3T2K9P5R1N0BX",          "title": "Acme raises full-year revenue guidance",          "outlet": "Example Wire",          "url": "https://news.example.com/acme-raises-guidance",          "published_at": "2026-11-03T14:05:00Z"        }      ],      "representative_article_id": "art_01JC4ZQ8M6W7Y3T2K9P5R1N0BX",      "first_article_at": "2026-11-03T14:05:00Z",      "last_article_at": "2026-11-03T14:05:00Z",      "updated_at": "2026-11-03T14:05:00Z"    }  }}