POST/api/v2/webhooks/{id}/test

Send a test event

Send a sample of one event (marked `test: true`) now, then see your system's response.

The sample is the same as in the Webhook events guide. Test events are not retried when they fail and do not count toward the webhook's health.

Send an Idempotency-Key header (for example a new UUID per request). A repeat with the same key within 24 hours gets the first answer again, so nothing is sent twice.

Key: kf_live_ / kf_test_… in the Authorization: Bearer header. Created in Settings › API & Webhook › Create key (Pengaturan › API & Webhook › Buat kunci).
Key scope: webhooks:manage
Plan feature: WhatsApp sending API

Path parameters

idintegerrequired
Webhook id.

Body (JSON)

eventstring: message.received | message.status | contact.created | lead.created | order.paid | ticket.created | ticket.status | template.status | channel.status
The event to sample, default message.received.

Possible errors

401 missing_key API key not sent
401 key_invalid Unknown API key
401 key_revoked API key revoked
401 key_expired API key expired
401 member_inactive Key creator is no longer a member
403 ip_not_allowed Server IP not in the key's list
403 plan_no_api Plan does not include the API for live keys
403 tenant_blocked Business access suspended
403 scope_missing Key lacks this permission
403 permission_missing Key creator's role lacks this permission
403 live_key_required Live key required
404 not_found Not found
422 invalid_request Invalid field
429 rate_limited Too many requests per minute
500 internal_error Problem at Klik Flow

Try it

This endpoint needs a live key, so it cannot be tried from the docs. Call it from your server.

Request example

curl -X POST "https://klikflow.id/api/v2/webhooks/6/test" \
  -H "Authorization: Bearer KUNCI_API" \
  -H "Idempotency-Key: 6f1c2a8e-4b1d-4c3a-9e2f-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{"event":"order.paid"}'

Response example 200

{
  "data": {
    "object": "webhook_delivery",
    "event_id": "evt_9Qx2Lm4Kp7Rt1Zs8",
    "event": "order.paid",
    "test": true,
    "succeeded": true,
    "status_code": 200,
    "error": null,
    "duration_ms": 182
  }
}

Path parameters

Body (JSON)

Possible errors

Try it

Send WhatsApp from your system with the Klik Flow API.