Create webhook
POST/v1/Webhooks
Creates webhook subscription for real-time event notifications.
Available Events:
client.onboarding.poa_signed- Client signed Power of Attorneyclient.onboarding.contract_signed- Client signed Service Delivery Agreementclient.linked- Client successfully linked to your accountclient.link_declined- Client declined to linkcase.created- Collection case created for linked clientcase.updated- Collection case lifecycle changed (e.g., Active → Closed)
Security: Response includes Base64-encoded signing secret (shown only once). Store it to verify HMAC-SHA256 signatures on deliveries.
Requirements: HTTPS URL required (HTTP, localhost, and private IPs rejected). Deliveries retry with exponential backoff (8 attempts). Webhook auto-disables after max failures.
Request
Responses
- 200
- 400
- 401
Webhook created successfully
Invalid request (validation errors)
API key is missing or invalid