Cari kontak

Kontak dalam cakupan pembuat kunci, diperbarui terakhir dulu.

Nomor disamarkan bila role pembuat kunci menyamarkannya.

Kunci: kf_live_ / kf_test_… di header Authorization: Bearer. Dibuat di Pengaturan › API & Webhook › Buat kunci.
Izin kunci: contacts:read
Fitur paket: API kirim WhatsApp

Parameter query

searchstring
Cari nama, nomor, email, perusahaan, atau kota.
limitinteger
1–100, bawaan 25.
cursorstring
next_cursor dari halaman sebelumnya.

Error yang mungkin

400 cursor_invalid Cursor tidak sah
401 missing_key Kunci API belum dikirim
401 key_invalid Kunci API tidak dikenal
401 key_revoked Kunci API sudah dicabut
401 key_expired Kunci API kedaluwarsa
401 member_inactive Pembuat kunci bukan anggota lagi
403 ip_not_allowed IP server tidak ada di daftar kunci
403 plan_no_api Paket belum memuat API untuk kunci live
403 tenant_blocked Akses bisnis ditangguhkan
403 scope_missing Kunci tidak punya izin ini
403 permission_missing Role pembuat kunci tidak punya izin ini
429 rate_limited Terlalu banyak permintaan per menit
500 internal_error Gangguan di Klik Flow

Coba

Coba sekarang dengan kunci tes

Kunci API tesHanya kunci tes (kf_test_…), disimpan di tab ini saja dan dikirim hanya ke API situs ini.

Parameter querysearchlimitcursor

/api/v2/contacts

Contoh permintaan

curl -X GET "https://klikflow.id/api/v2/contacts?search=rina" \
  -H "Authorization: Bearer KUNCI_API"

Contoh jawaban 200

{
  "data": [
    {
      "id": 301,
      "object": "contact",
      "name": "Rina",
      "phone": "6281234567890",
      "email": "rina@contoh.com",
      "company": null,
      "city": "Bandung",
      "source_channel": "whatsapp",
      "custom_fields": {
        "member": "Gold"
      },
      "created_at": "2026-10-01T03:00:00.000Z",
      "updated_at": "2026-11-01T02:10:00.000Z"
    }
  ],
  "next_cursor": null
}

Parameter query

Error yang mungkin

Coba

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.