Webhooks
Stacklift sends signed HTTP POST requests when things happen. Create endpoints under Integrations → Webhooks; the signing secret (whsec_…) is shown once.
Events
release.created, release.ready, release.failed, deployment.succeeded, deployment.failed, rollout.updated, rollback.created, plus ping for tests.
json
{
"id": "5a1f…",
"event": "deployment.succeeded",
"orgId": "…",
"projectId": "…",
"createdAt": "2026-11-17T10:21:04.000Z",
"data": { "deploymentId": "…", "releaseId": "…", "channelId": "…" }
}Verifying a delivery
Headers: Stacklift-Event, Stacklift-Delivery, Stacklift-Signature: t=<unix>,v1=<hex>. The signature is HMAC-SHA256(secret, "<t>.<raw body>"). Compare in constant time and reject timestamps older than five minutes.
ts
import { createHmac, timingSafeEqual } from 'node:crypto';
export function verify(rawBody: string, header: string, secret: string) {
const [t, v1] = header.split(',').map((p) => p.split('=')[1]!);
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
const expected = createHmac('sha256', secret).update(`${t}.${rawBody}`).digest('hex');
return timingSafeEqual(Buffer.from(v1), Buffer.from(expected));
}Delivery semantics
- Delivered at least once; use
Stacklift-Deliveryto de-duplicate. - Non-2xx responses and timeouts (10 s) are retried with exponential backoff, up to 5 attempts. Every attempt appears in the delivery log.
- Redirects are not followed.
- In production, targets must be
httpsand must not resolve to loopback, private or link-local addresses (SSRF guard, re-checked at delivery time).
Slack and Discord notifications are planned. Until then, point a webhook at a relay (for example a Slack incoming-webhook adapter you host).