Essal Sales lets you import contact records in bulk from a CSV file or directly via the API. The import pipeline handles field mapping, validation, and deduplication before persisting records.
CSV Import
Prepare Your File
The CSV must include a header row. At minimum, a email or display_name column is required:
Submit the Import Job
The field_map object lets you map CSV column names to Essal Sales field names where they differ.
Duplicate Handling
The on_duplicate option controls what happens when an imported contact matches an existing record (matched by email):
API Import
For programmatic imports, push contacts individually or in batches:
Batch requests support up to 200 contacts per call.
Checking Import Status
Both CSV and batch imports are processed asynchronously. Poll the job endpoint for progress:
Subscribe to the sales.import.completed event to receive a notification when large import jobs finish, rather than polling.
