Skip to main content
POST
Validate CSV

Endpoint

Overview

Content-Type: multipart/form-data. Response: JSON with ok: true or ok: false plus error details (missingCsvColumns, etc.). Uses HTTP 200 even when validation fails β€” check ok. For mappings with target === user_event, the API also validates each data row after headers pass (mapping, enum values, required identifiers). Other targets still validate headers only.

Authentication

Form fields

Success β€” headers only (transaction, entity_*)

Success β€” user events (all rows valid)

Row validation failure β€” user events

When one or more rows fail mapping validation:
Use this preflight before import. With batchErrorHandling: continue_collect_errors on Import user events, invalid rows are skipped and recorded in the job failures CSV; with rollback_all, the import request returns 400. See also: Bulk imports overview.