Buat kontak

Tambah kontak baru dengan nomor atau email.

Kontak dengan nomor atau email yang sama ditolak (409) dengan id yang sudah ada. Batas kontak paket berlaku. Field kustom memakai kunci field dari Pengaturan › Kontak.

Kirim header Idempotency-Key (misalnya UUID baru per permintaan). Ulangan dengan kunci yang sama dalam 24 jam mendapat jawaban pertama lagi, jadi tidak terkirim dua kali.

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

Body (JSON)

namestringwajib
Nama kontak.
phonestring
Nomor dengan kode negara. Wajib bila tanpa email.
emailstring
Email. Wajib bila tanpa nomor.
companystring
Perusahaan.
citystring
Kota.
custom_fieldsobject
Nilai field kustom per kunci field.

Error yang mungkin

400 invalid_json Body bukan JSON yang sah
400 idempotency_key_invalid Idempotency-Key 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
409 idempotency_conflict Idempotency-Key dipakai untuk isi lain
409 request_in_progress Permintaan yang sama masih diproses
422 invalid_request Field tidak sah
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. Body (JSON)Idempotency-Key

/api/v2/contacts

Contoh permintaan

curl -X POST "https://klikflow.id/api/v2/contacts" \
  -H "Authorization: Bearer KUNCI_API" \
  -H "Idempotency-Key: 6f1c2a8e-4b1d-4c3a-9e2f-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{"name":"Rina","phone":"6281234567890","city":"Bandung","custom_fields":{"member":"Gold"}}'

Contoh jawaban 201

{
  "data": {
    "id": 301,
    "object": "contact",
    "name": "Rina",
    "phone": "6281234567890",
    "email": null,
    "company": null,
    "city": "Bandung",
    "source_channel": null,
    "custom_fields": {
      "member": "Gold"
    },
    "created_at": "2026-11-01T02:12:03.000Z",
    "updated_at": "2026-11-01T02:12:03.000Z"
  }
}

Body (JSON)

Error yang mungkin

Coba

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.