Ubah kontak

Ubah field kontak; hanya field yang dikirim yang berubah.

Aturan sama dengan mengubah kontak di aplikasi, termasuk pemeriksaan nomor dan field kustom.

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

Parameter alamat

idintegerwajib
Id kontak.

Body (JSON)

namestring
Nama.
phonestring
Nomor.
emailstring
Email.
citystring
Kota.
custom_fieldsobject
Field kustom yang diubah.

Error yang mungkin

400 invalid_json Body bukan JSON yang 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
404 not_found Tidak ditemukan
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.

Parameter alamatid

Body (JSON)Idempotency-Key

/api/v2/contacts/{id}

Contoh permintaan

curl -X PATCH "https://klikflow.id/api/v2/contacts/301" \
  -H "Authorization: Bearer KUNCI_API" \
  -H "Idempotency-Key: 6f1c2a8e-4b1d-4c3a-9e2f-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{"city":"Jakarta","custom_fields":{"member":"Platinum"}}'

Contoh jawaban 200

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

Parameter alamat

Body (JSON)

Error yang mungkin

Coba

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.