Webhook Testing

The Webhook Test tool lets you simulate webhook events and inspect payloads directly from your dashboard — no external tools required.

How It Works

1. Generate a test URL — The dashboard creates a unique test endpoint for your account.
2. Simulate events — Click any event type button to generate a sample payload.
3. Inspect payloads — Each simulated event appears in the event log with full JSON payload, timestamp, and event type.

Supported Event Types

You can simulate events across all channels:

SMS

• sms.sent — Message accepted for delivery
• sms.delivered — Message delivered to handset
• sms.failed — Delivery failed

Email

• email.sent — Email accepted by receiving server
• email.opened — Recipient opened the email
• email.clicked — Recipient clicked a tracked link
• email.bounced — Email bounced (hard or soft)

WhatsApp

• whatsapp.message.sent — Message dispatched
• whatsapp.message.received — Incoming message received

OTP / Verify

• verify.sent — OTP code dispatched
• verify.completed — OTP successfully verified

Test Payload Format

Each simulated event produces a JSON payload matching the production webhook format:

{
  "event": "sms.delivered",
  "data": {
    "id": 4821,
    "status": "delivered",
    "to": "+254712345678"
  },
  "timestamp": "2026-03-26T01:00:00.000Z"
}

Using with Production Webhooks

You can also point your real webhook endpoint URL at the test URL to debug incoming payloads. Copy the test URL and set it in your webhook configuration to capture live events.

TIP

For production webhook setup and signature verification, see the Webhooks Overview and Webhook Best Practices guide.