Webhooks

Stream Pivotal events to your own systems. Subscribe to an endpoint, pick the events you care about, and we’ll POST a signed payload whenever they happen. Deliveries are retried for 24 hours with exponential backoff.

Outbound delivery runs on Svix. The signing headers, retry schedule, and verification libraries are the standard Svix ones — drop in any Svix SDK and it works against Pivotal without custom code.

Open Admin → Developer → Webhooks in your workspace.
Click Add endpoint, paste your HTTPS URL, pick the event types to receive.
Copy the signing secret — Svix shows it once. Store it in your secret manager.
Test from the dashboard with Send test event. The same UI lists every past delivery with status, payload, and a one-click Replay.

WHAT TO READ NEXT

Quickstart

Receive your first event in under five minutes. Local tunnel + signing verification.

Event envelope

The standard shape every payload arrives in. id, type, timestamp, org, data.object.

Receiving webhooks

Node/Express and Python/FastAPI handlers, ready to copy.

Signature verification

HMAC verification in TypeScript and Python.

Retries and backoff

24h exponential schedule. What counts as success. When delivery gives up.

Testing in test mode

Fire real events from pivotal_test_ keys without polluting production data.

EVENT REFERENCE

Fifteen event types ship today, grouped by resource. Each page documents the payload shape, when it fires, a copyable JSON example, and common use cases.

Customer events (6)

Created, updated, archived, health score dropped, at risk, churned.

Contact events (1)

Created.

Onboarding events (7)

Created, phase changed, state changed, at risk, back on track, launched, completed.

Task events (1)

Completed.