Cove sends HTTP POST requests to your configured webhook_url when bureau submission statuses change.
Event types
Every webhook POST includes these headers:
Signature verification
The X-Cove-Signature header contains an HMAC-SHA256 digest of the raw request body, signed with your webhook_secret.
Retry behavior
- Each attempt has a 10-second timeout.
- After all retries are exhausted, the event is marked as
failed.
Fallback: Poll GET /submissions to check status if webhooks are missed.
Best practices
- Return 2xx quickly — process webhook data asynchronously. The 10-second timeout is strict.
- Handle duplicates — webhooks may be delivered more than once. Use the
id field for idempotency.
- Use
GET /submissions for reconciliation — don’t rely solely on webhooks for critical business logic.