Webhooks
Get told about replies, accepted invites, finished actions and sender health.
Add an endpoint under Webhooks in the dashboard and choose the events you want.
| Event | When |
|---|---|
message.received | A contact replied in a thread. |
connection.accepted | A contact accepted a connection request. |
action.succeeded | A queued action ran successfully. |
action.failed | A queued action failed. |
sender.health_changed | A sender's health bucket changed (healthy, throttled, critical, stopped). |
sender.paused | A sender was paused by a checkpoint, restriction or expired session. |
sender.resumed | A paused sender is active again. |
Verifying a delivery
Every delivery carries a SendCrew-Signature header: a timestamp and an HMAC-SHA256 of "<timestamp>.<raw body>" made with your endpoint's signing secret.
import crypto from "node:crypto";
// SendCrew-Signature: t=1732170000,v1=<hex>
const [t, v1] = header.split(",").map((p) => p.split("=")[1]);
const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
const ok = crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(expected));Use the raw request body, not re-serialised JSON.
Retries
Answer with a 2xx status within a few seconds. Failed deliveries are retried with growing gaps over about 15 hours, then marked failed. You can see every delivery and its response in the dashboard.