# Webhook events

> For the complete documentation index, see [llms.txt](https://www.shortsintel.com/llms.txt). Every docs page is also available as markdown: add .md to its URL. To connect, read [agents.md](https://www.shortsintel.com/agents.md).

The events we send to your webhook endpoints, and their payloads. To register, list or rotate an endpoint, see the [Webhooks](https://www.shortsintel.com/docs/reference/webhooks) endpoints. Verify every delivery: [Verifying a signature](https://www.shortsintel.com/docs/concepts/webhooks#verifying-a-signature).

| Event | When it fires |
| --- | --- |
| [run.completed](https://www.shortsintel.com/docs/reference/events/run.completed) | A Run reached a terminal state: completed, partial or failed. The type is `run.completed` for all three; branch on `status` in the payload. |
| [tracker.changed](https://www.shortsintel.com/docs/reference/events/tracker.changed) | A Tracker cycle produced a Change Report. Quiet cycles send nothing. The report's `triggers` name what tripped: on a Creator Tracker `new_videos`, `followers`, `outlier`, `velocity`, `became_ad`, `bio_link_changed` and `verified_changed`; on Hashtag and Keyword Trackers `median_views` and `new_top_videos`; on Sound Trackers `video_count` and `new_top_video`; on Advertiser Trackers `new_ads`, `stopped_ads`, `variant_growth`, `new_countries_or_placements`, `crossed_30_days`, `refresh_burst` and, on TikTok, `reach_growth`. |
| [webhook.test](https://www.shortsintel.com/docs/reference/events/webhook.test) | Sent once when an endpoint is registered, to prove it. A 2xx makes the endpoint `active`. |
