Help Center/Admin Operations/How to register an outbound webhook and verify its signature
Admin Operations•Last updated: 2026-10-20•3 min read

How to register an outbound webhook and verify its signature

Register an https endpoint, test it and verify the HMAC signature on the receiving side.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Register

Admin → Integrations → Webhooks → New Record (Super Administrator): URL, description, events (payment.verified today). Store the signing secret from the banner.

2

Test

The row icon "Send a signed test event" delivers a webhook.test event and tells you the real result.

3

Verify on your server

Compute HMAC-SHA256 of "<X-I8-Timestamp>.<raw body>" with the secret and compare, in constant time, with the X-I8-Signature header (format v1=<hex>). Reject timestamps older than five minutes.

4

Operate

Failures retry after 1, 5, 30, 120 and 360 minutes and then dead-letter; "Re-queue dead-lettered deliveries" replays them. "Rotate signing secret" invalidates the old secret at once.

Expected Operational Outcome

Your endpoint receives signed events and rejects tampered or stale ones.

Troubleshooting & Failure Modes

Symptom: "The webhook URL was refused"
Likely Cause: Only public https hosts are accepted (no IP literals, internal names, credentials or custom ports).
Resolution: Use a public DNS name on port 443.

Was this guide helpful?

Help us refine our platform documentation