Webhooks
Getting started
Register an endpoint and receive signed events.
Webhooks push events to your server when new data lands. They're available on Builder and above.
Register an endpoint
curl https://api.signals.ai/v1/webhook-endpoints \
-H "Authorization: Bearer $SIGNALS_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://acme.dev/hooks/signals", "topics": ["filing.created", "form4.filed"]}'The response includes a signing_secret (whsec_…) shown once — store it to
verify deliveries.
Topics
| Topic | Fires when |
|---|---|
filing.created | A new SEC filing is indexed for a covered issuer. |
transcript.published | A first-party transcript passes the serving gate. |
ir_document.created | A new IR document (deck / press release) is captured. |
form4.filed | A new Form 4 insider transaction is ingested. |
datapoint.published | A served datapoint appears (see Data events). |
datapoint.corrected | A served datapoint changes: value, tagging or merging. |
company.data_updated | A company's datapoints for a period changed. |
document.added | A filing, transcript or IR document is admitted for serving. |
Send a test event any time: POST /v1/webhook-endpoints/{id}/test with an optional {"topic": "..."} body.