Skip to Content
SendCrew

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.

EventWhen
message.receivedA contact replied in a thread.
connection.acceptedA contact accepted a connection request.
action.succeededA queued action ran successfully.
action.failedA queued action failed.
sender.health_changedA sender's health bucket changed (healthy, throttled, critical, stopped).
sender.pausedA sender was paused by a checkpoint, restriction or expired session.
sender.resumedA 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.