Create New Rows

Adds multiple rows to an audience in a single bulk operation. Use this endpoint when importing contact or company records into an existing audience — for example, after a CRM export, a CSV upload, or a manual list build. Each row in the request body specifies cell values keyed by columnId. You cannot provide values for id columns — these are system-generated. By default, runEnrichment is false — enrichment does not run automatically after rows are created; set it to true in the request metadata to enable it. To enrich only specific columns on creation, provide columnId values in the metadata columns field; if omitted, all enrichable columns are processed. This operation is asynchronous. Returns 202 Accepted with a jobId. Poll the Get Bulk Job Status endpoint at GET /v1/audiences/{audienceId}/rows/actions/bulk/job/{jobId} using that jobId to confirm when all rows have been created and enrichment is complete. 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

Indicates whether to run enrichment on the created/updated rows. If true, the system will attempt to enrich the rows with additional data based on the provided information. Default is false.

columns
array of strings

Optional List of column IDs to enrich for each row, if provided will enrich only the specified columns instead of all enrichable columns. This parameter is considered only if runEnrichment is true.

columns
Body Params

Request body containing the row creation details

data
array of objects
required
length between 1 and 1000

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