API & webhooks
Build on top of the signal layer
Send any event into Synapse with one request, read the same account data your team sees, and get a signed webhook the moment an alert fires.
import { Synapse } from "@synapse/node"; const synapse = new Synapse(process.env.SYNAPSE_KEY); // send a custom event await synapse.events.send({ account: "northwind.com", event: "report_exported", properties: { format: "csv", rows: 1840 }, }); // read an account's health const acct = await synapse.accounts.get("northwind.com"); console.log(acct.health.score); // 94
What you can do
Everything in the app is in the API
Events API
Send custom events with up to 1,000 per batch. Ordering, deduplication and identity resolution work the same as for our connectors.
Accounts API
Read accounts, owners, health scores and timelines. Write custom traits back to enrich your view.
Webhooks
Receive alerts, score changes and new accounts as signed JSON payloads, with automatic retries.
Scoped keys
Create read-only, write-only or full keys per environment, and rotate them without downtime.
Generous limits
1,000 requests per second on Growth and higher limits on Scale, with clear rate-limit headers.
Official SDKs
Typed clients for Node, Python, Go and Ruby, plus an OpenAPI spec for everything else.
Webhooks
Alerts that reach your own systems
Point a webhook at any URL and Synapse posts a signed payload whenever an alert fires. Verify the signature, act on it, and let us retry if your endpoint is down.
- HMAC-SHA256 signatures on every request
- Retries with exponential backoff for 24 hours
- Delivery log with replay from the dashboard
{
"type": "alert.triggered",
"alert": {
"name": "Churn risk",
"account": "fieldstone.io",
"metric": "weekly_active_users",
"change": -0.38,
"owner": "jamie@acme.com"
},
"created_at": "2026-10-14T09:12:44Z"
}
Developer resources
Start with the guide that fits
Your API key is one sign-up away
Free for up to 5,000 events a month. No credit card required.