PATCH/api/v2/contacts/{id}

Update a contact

Change contact fields; only the fields sent change.

Same rules as editing a contact in the app, including the number and custom field checks.

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: contacts:write
Plan feature: WhatsApp sending API

Path parameters

idintegerrequired
Contact id.

Body (JSON)

namestring
Name.
phonestring
Number.
emailstring
Email.
citystring
City.
custom_fieldsobject
Custom fields to change.

Possible errors

400 invalid_json Body is not valid JSON
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
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

Try it with a test key

Test API keyTest keys only (kf_test_…), kept in this tab only and sent only to this site's API.

Path parametersid

Body (JSON)Idempotency-Key

/api/v2/contacts/{id}

Request example

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"}}'

Response example 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"
  }
}

Path parameters

Body (JSON)

Possible errors

Try it

Send WhatsApp from your system with the Klik Flow API.