platform
CSV import
activeA CSV import loads users or events from a file instead of sending them call by call. Each row follows the same identity rule as an Identify or Track call: it must carry at least one identifier from your workspace's identity strategy.
Identifier columns
Every row needs a value in at least one identifier column. Which columns count depends on the workspace's identity strategy:
| Import type | Identifier columns |
|---|---|
| Users | userId, anonymousId, and (when enabled) phone, email and custom identifier traits by name |
| Events | userId, anonymousId, and context.traits.<trait> / context.device.<field> for enabled identifiers, e.g. context.traits.phone, context.device.id |
Validation
| Problem | Result |
|---|---|
| The file has no identifier column | Rejected at preview |
| A row has no identifier value | Reported in the error file |
A phone or email value is malformed (format check on) | Reported on its column |
Import order
Events do not update profiles. A profile created only from imported events is keyed by its identifier but has no traits until users are imported, so import users first, then events.