v1

latestOpenAPI 3.0.32026-07-26737274.2 KB
Custom Fields

Bulk update subscriber custom field values

Creates or updates custom field values for many subscribers in one request. Each entry in custom_field_values pairs a subscriber_id with a subscriber_custom_field_id and the value to set. Requires OAuth authentication.

Requests with 100 or fewer values are processed synchronously (200); larger requests are processed asynchronously (202) — provide a callback_url to be notified on completion, and see Bulk & async processing for how async requests behave. Returns 413 when the request would exceed the account's data limit for enqueued bulk requests.

The custom fields must already exist — entries referencing an unknown subscriber_custom_field_id are rejected individually with a Custom field does not exist error in the response's failures list, while the rest of the batch is still processed. See List custom fields and Bulk create custom fields.

post/v4/bulk/custom_fields/subscribers

Request body

{"stackTrail":"paths:/v4/bulk/custom_fields/subscribers:post:requestBody:content:application/json:schema:properties:callback_url","oasType":"schema","type":"unknown","nullable":true}

Response

Creates or updates custom field values synchronously when 100 or less values are requested