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 401What 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
No deliveries yet.