Skip to content

Webhooks

Get a signed request at your URL when a list finishes, instead of checking back. Add the URL when you upload a list.

Signing secret

Every request carries an HMAC-SHA256 of its body, made with this secret, in the X-EVA-Signature header. Check it before you act on the request.

Your secret didn't load. Refresh the page to try again.

You don't have a secret yet.

Test signing secret

Sandbox webhooks (from test keys and sandbox connections) are signed with this secret.

Check the signature

In Python, for example:

verify_signature.py
import hmac, hashlib

def verify_signature(body, secret, signature):
    expected = hmac.new(
        secret.encode(), body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

# In your webhook handler:
sig = request.headers.get("X-EVA-Signature")
if not verify_signature(request.body, SECRET, sig):
    return 401

What the request contains

One JSON body per finished list:

{}webhook.json
{
  "event": "bulk_job.completed",
  "job_id": "3f1c9a2e-…",
  "status": "completed",
  "total_count": 10000,
  "completed_count": 10000,
  "summary": {
    "safe": 7420, "risky": 610, "catchall": 880,
    "invalid": 950, "unknown": 140
  },
  "result_url": "https://api.kavik.email/api/v1/verify/async/3f1c9a2e-…/result",
  "timestamp": "2026-10-27T09:30:00Z"
}

Recent deliveries

List URL Status Attempts Response When

No deliveries yet.