Skip to main content
Cove sends HTTP POST requests to your configured webhook_url when bureau submission statuses change.

Event types

Payload format

Headers

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.