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.

node · synapse.js
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
alert.triggered
{
  "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"
}

Your API key is one sign-up away

Free for up to 5,000 events a month. No credit card required.