Panel Webhooks

Configure

In a subscription:

1. Set Webhook URL.
2. Keep Enable Webhook enabled.
3. Save.

Verify Endpoint

On the subscription detail screen use Verify Webhook. Kvasyr sends a verification request and expects token confirmation.

Send Test Delivery

Use Test Webhook to send a signed sample payload. This validates connectivity and signature handling before live traffic.

Live deliveries use a batched envelope:

• Header: x-kvasyr-batch-id
• Body: { version: "kvasyr.v2", subscription_id, batch_id, events: [...] }
• Event identifiers: events[].id

Secret Handling

Webhook secrets are shown only when created/regenerated. Store immediately in your secret manager.

If compromised, regenerate and update your receiver.

Regenerate Secret

On the subscription detail screen, Regenerate Secret immediately rotates the webhook signing secret for that subscription.

• The previous secret stops working right away.
• New webhook signatures are generated with the new secret.
• You must update your receiver before expecting future deliveries to verify.

Use this when a secret is exposed, copied into logs, or shared in an unsafe way.

Troubleshooting

• HTTP error: endpoint logic/auth issue.
• Connection error: DNS/TLS/firewall/network issue.
• URL changed: verify again.