Bulk Upsert Rows

Creates and/or updates multiple rows in an audience in a single bulk operation. Each entry in the request body includes cell values keyed by columnId. Including a rowId updates that existing row; omitting rowId creates a new row. Both creates and updates can be combined freely in the same request. By default, runEnrichment is false — enrichment does not run automatically; set it to true to trigger enrichment on affected rows after the upsert. To limit enrichment to specific columns, provide columnId values in the columns query parameter; if omitted, all enrichable columns are processed. Returns 200 with data[] row resources — each entry includes id, type, and attributes.values with full cell details (columnId, value, state, and errorDetails when applicable). Returns 400 if the request body is malformed or columnId references are invalid.

Path Params
uuid
required

The unique identifier for the audience

Query Params
boolean
Defaults to false

When true, enrichment runs automatically on all affected rows after the upsert completes. Defaults to false.

columns
array of strings

List of columnId values to enrich per row. Only used when runEnrichment is true; if omitted, all enrichable columns are processed.

columns
Body Params

Request body containing rows to create or update. Include id (rowId) to update an existing row; omit id to create a new row.

JSON API model for bulk upsert Row request. Row id is optional — omit to create, provide to update.

data
array of objects
required
length between 1 and 500

The primary data of the document

data*
Responses

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