Webhooks
Get notified the moment a job or pipeline changes state — no polling required.
What you can subscribe to
Register a webhook URL to receive events as your work progresses. Events cover both individual jobs and bundled pipelines:
- Job events — stage transitions and terminal states (completed / failed).
- Pipeline events — completed, partially failed, or expired bundles.
You can filter which events each webhook receives, so you only get the notifications you care about.
Verifying signatures
Each webhook has its own signing secret (prefixed whsec_). VocaSync signs every delivery with HMAC so you can confirm a payload genuinely came from us and wasn’t tampered with in transit. Each payload also carries a digest you can check.
Always verify before acting
Delivery & retries
Deliveries are tracked, and failed attempts are retried automatically. Make your endpoint idempotent — the same event may be delivered more than once — by de-duplicating on the event identifier.
Related
- API keys & authentication — create keys to submit the jobs you’ll get webhooks for.
- API reference — webhook payload schemas and signature details.