Batch update subscribers

Updates multiple subscriber records in a single request using direct database writes.

Note: Unlike the single-subscriber update endpoint, this operation does not
run form pipelines, automations, or timing operations. It is a lightweight bulk field update.

Identifying records

Each item in the array must identify the record to update using one of:

  • id: the numeric subscriber record ID
  • mssys_idparam: an object of {fieldName: value} pairs used as the WHERE clause

Error codes

CodeMeaning
10100Empty or non-array request body
10101A record item is not an object
18005A field in mssys_idparam does not exist on this list
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

Subscriber list (newsletter) ID

Body Params

A single record to update. Must contain either id or mssys_idparam.

integer

Subscriber record ID (used as the WHERE clause)

mssys_idparam
object

Key-value pairs used as the WHERE clause. All keys must be valid list fields.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json