Import user events (CSV)
API Reference
Import user events (CSV)
Upload a CSV and enqueue user-event batch import using a saved mapping β via the gu1 batch import API for high-volume data loading.
POST
Import user events (CSV)
Endpoint
Overview
Content-Type:multipart/form-data.
Permissions: events:create.
Authentication
Form fields
| Field | Required | Description |
|---|---|---|
file | Yes | CSV file |
mappingId | Yes | Mapping with target === user_event |
executeRules | No | true (default) or false |
withAutoEntity | No | true (default) or false |
Limits
| Value | |
|---|---|
| Files per request | 1 CSV |
| Max rows per import | By plan β Bulk imports overview β Limits by plan |
| Server cap (optional) | USER_EVENT_BATCH_IMPORT_MAX_ROWS may lower the plan limit |
| Over limit | 400 TOO_MANY_ITEMS |