Skip to main content
platform

CSV import

active
Audience: developerUpdated 2026-10-05

A 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 typeIdentifier columns
UsersuserId, anonymousId, and (when enabled) phone, email and custom identifier traits by name
EventsuserId, anonymousId, and context.traits.<trait> / context.device.<field> for enabled identifiers, e.g. context.traits.phone, context.device.id

Validation​

ProblemResult
The file has no identifier columnRejected at preview
A row has no identifier valueReported 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.