custom-fields
Set custom-field values on contacts (v2)
Batch-set per-contact custom-field VALUES (the contacts_custom_fields rows, not the field definitions). Body: { custom_fields: [{ contact_id, custom_field_id, text_value?, array_value?, date_value? }] }. Requires Idempotency-Key. Returns { data: { affected } } (count of successful updates; per-row failures are skipped and logged).
post/v2/custom-fields/contacts/values
Headers
Idempotency-Keystring required
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A
Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.
Request body
Response
Successful response