Skip to main content
PATCH
Write custom column values (keyed by contact id)

Authorizations

Authorization
string
header
required

Your API token (af_…) as the Basic-auth username, with an empty password.

Path Parameters

listId
string
required

24-character hex id of the list (from GET /business/lists).

columnId
string
required

24-character hex id of the custom column (from GET /business/lists/{listId}/columns).

Body

application/json
values
object[]
required

Cells to write, at most 500 per call: each entry is an independent write of one contact's cell in this column, and entries do not combine — send at most one entry per contact, because two entries for the same contact are applied concurrently and which value survives is undefined. Every contactId must already be a row of this list, and every value must convert to the column's type, or the call answers 422 — a type failure is caught before anything is written, but an entry rejected for not being on the list can leave siblings from the same call already written. The response's updatedCount is the number of entries submitted, not the number of cells changed. See value for the accepted values per column type.

Required array length: 1 - 500 elements

Response

Success

updatedCount
integer
required