Validate CSV
API Reference
Validate CSV
Preflight: validate CSV headers against a saved mapping β via the gu1 batch import API for high-volume data loading, with examples for validate csv use cases.
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: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.