Docs / Contacts and segments / CSV import and export

CSV import and export

Last updated: 29 October 2026

You import contacts into Stravax Engage by uploading a CSV file, mapping its columns to contact fields, and reviewing a dry-run preview before anything is written. Rows that match an existing contact by phone number update that contact instead of creating a duplicate. You can also export your contact book to CSV at any time.

How do I map CSV columns?

The import screen suggests a column mapping automatically, matching your file's headers to contact fields and to your organization's custom fields by name. You review and adjust that mapping before running the import. Columns you leave unmapped are simply not imported, that's a mapping choice, not an error.

You can map columns to:

What does the dry-run preview show?

A dry-run runs the exact same validation as a real import but writes nothing. It reports how many rows would be created, how many would update an existing contact, and how many have a problem, with the specific reason listed per row, for example an invalid phone number, a value that isn't one of a picklist's options, or a non-numeric value in a number field.

The preview is a check before import. Contact data or plan limits can change before the import is confirmed, so review the final result.

In the new look, if a phone number lacks a country code, the file is held and nothing is imported. Correct the listed rows and try again.

How does import handle duplicate contacts?

Phone numbers are normalized to the same format used everywhere else in the product, so an import row matches an existing contact reliably. A row whose phone number already exists in your contact book updates that contact. A row with a new phone number creates a new contact. If the same phone number appears more than once in one file, only the first occurrence counts as new; the rest are treated as the same contact.

What if my file is too large or I import too often?

Import is rate limited per organization to prevent abuse, and a file is checked against a size and row-count limit before it's parsed, so an oversized file is rejected right away rather than partially processed. If an import would take you over your plan's contact limit, the rows that would exceed it are reported as invalid rather than silently dropped. See current plans for contact limits.

How do I export contacts?

Export downloads your contact book as a CSV file, scoped to your organization only. Exported values are protected against spreadsheet formula injection, so a value starting with a character like = won't run as a formula when you open the file in Excel or Google Sheets.

Related articles

More in Contacts and segments