Skip to main content
POST
Import user events (CSV)

Endpoint

Overview

Content-Type: multipart/form-data. Permissions: events:create.

Authentication

Form fields

Row error policy (batchErrorHandling)

Legacy alias: stopOnFirstError=true maps to stop_keep_success.

Limits

Success response

202 Accepted
  • totalItems β€” valid rows queued + preflight failures (mapping errors skipped under continue policy).
  • preflightFailures β€” rows that failed mapping validation before the worker ran (download failures CSV from unified history when the job completes).

Pre-job errors

See Batch import failure codes. See also: Bulk imports overview.