GET/api/v2/webhooks

List webhooks

This business's webhooks, with their events, 7-day health, and number of failed deliveries.

Same as Settings › API & Webhook › Webhook (Pengaturan › API & Webhook › Webhook). Live keys only: webhooks receive real events. The secret is never in this response.

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

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
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 GET "https://klikflow.id/api/v2/webhooks" \
  -H "Authorization: Bearer KUNCI_API"

Response example 200

{
  "data": [
    {
      "id": 6,
      "object": "webhook",
      "url": "https://toko-anda.id/klikflow/webhook",
      "description": "Server toko",
      "events": [
        "message.received",
        "message.status",
        "order.paid"
      ],
      "status": "active",
      "paused_reason": null,
      "health": "Sehat · 99,8% sukses 7 hari",
      "failed_count": 0,
      "created_at": "2026-11-01T02:00:00.000Z",
      "last_success_at": "2026-11-01T02:12:04.000Z",
      "last_failure_at": null
    }
  ],
  "next_cursor": null
}

Possible errors

Try it

Send WhatsApp from your system with the Klik Flow API.