Event reference
All event types
Every eventType, subEventType and signalType Signals sends, with the platform field and the header values, plus code that filters on them.
Signals sends 18 kinds of event. Each has an eventType (the family), a subEventType (the platform) and a signalType (the product event name).
How to read this page
A run webhook names its family in eventType and counts each event name in events, so you can route a POST before you read a page. Each event in a page's items has its own eventType and subEventType. The platform field is the one key in the body that holds the item details. See Event shape.
Every event
signalType shows the new name first. The updated and removed names are in the next section. Today only job postings send removed (jobs.removed).
| eventType | subEventType | source | signalType (new) | Platform field | Webhook filter |
|---|---|---|---|---|---|
ads | google_ad | ads | ads.new | adsResponse | ads / google_ad |
ads | meta_ad | ads | ads.new | adsResponse | ads / meta_ad |
ads | linkedin_ad | ads | ads.new | adsResponse | ads / linkedin_ad |
reviews | g2_review | reviews | reviews.new | reviewResponse | reviews / g2_review |
reviews | trustpilot_review | reviews | reviews.new | reviewResponse | reviews / trustpilot_review |
reviews | capterra_review | reviews | reviews.new | reviewResponse | reviews / capterra_review |
reviews | trustpilot_de_review | reviews | reviews.new | reviewResponse | reviews / trustpilot_de_review |
reviews | capterra_de_review | reviews | reviews.new | reviewResponse | reviews / capterra_de_review |
reviews | boxil_review | reviews | reviews.new | reviewResponse | reviews / boxil_review |
social_post | linkedin_post | linkedin | social.post | socialPostResponse | social_post / linkedin_post |
social_post | x_post | x | social.post | socialPostResponse | social_post / x_post |
social_post | instagram_post | instagram | social.post | socialPostResponse | social_post / instagram_post |
mention | linkedin_mention | linkedin_mentions | social.mention | mentionResponse | mention / linkedin_mention |
mention | reddit_mention | reddit_mentions | social.mention | mentionResponse | mention / reddit_mention |
jobs | job_posting | job_postings | jobs.new | jobResponse | jobs / job_posting |
news | news_article | news | news.article | newsResponse | news / news_article |
website | website_change | website | website.changed (action: "updated") | websiteResponse | website / website_change |
competitor | new_competitor | competitor_discovery | market.new_competitor | competitorResponse | competitor / new_competitor |
The action field maps to the change: new for a first sighting, updated for a changed item, removed for one that is gone. Website events are the exception: a changed page is action: "updated" with signalType: "website.changed". website.page_removed is in the schema but never sent. website.page_added is listed in a website run webhook with total: 0, and has no events today.
signalType per source
These are all the names in the schema. The pull API can return all of them. A run webhook has one section per name its tracker can send: see Event names per family.
| source | new | updated | removed |
|---|---|---|---|
ads | ads.new | ads.updated | ads.removed |
reviews | reviews.new | reviews.updated | reviews.removed |
news | news.article | news.article_updated | news.article_removed |
linkedin, x, instagram | social.post | social.post_updated | social.post_removed |
linkedin_mentions, reddit_mentions | social.mention | social.mention_updated | social.mention_removed |
job_postings | jobs.new | jobs.updated | jobs.removed |
website | website.page_added | website.changed | website.page_removed |
competitor_discovery | market.new_competitor | market.competitor_updated | market.competitor_removed |
linkedin_engagement (pull API only) | engagement.new | engagement.updated | engagement.removed |
LinkedIn engagement has no webhook
linkedin_engagement has no eventType and no subEventType. It is never sent by webhook or posted to Slack. Read it from the pull API.