Import Contacts¶
Upload a CSV file to add or update multiple contacts at once.
CSV format¶
Your CSV file must have a header row. The following column names are recognized:
| Column | Required | Description |
|---|---|---|
phone |
Yes | Phone number with country code (e.g. +15551234567) |
first_name |
No | Contact's first name |
last_name |
No | Contact's last name |
email |
No | Email address |
company |
No | Company name |
Column names are case-insensitive and spaces are stripped. Extra columns are ignored.
Example CSV¶
phone,first_name,last_name,email
+15551234567,John,Doe,[email protected]
+15559876543,Jane,Smith,[email protected]
+541112345678,Carlos,López,[email protected]
Importing¶
- Go to Contacts → Import Contacts
- Click Choose File and select your CSV
- Map columns (if auto-detection is incorrect)
- Optionally select a Group to add all imported contacts to
- Click Import
Duplicate handling¶
The import uses the phone number as the unique key:
- If a contact with that phone already exists → their record is updated with the new data
- If no contact has that phone → a new contact is created
Phone number format¶
All phone numbers must include the country code with a leading +:
| Format | Valid? |
|---|---|
+15551234567 |
Yes |
+541112345678 |
Yes |
5551234567 |
No — missing country code |
(555) 123-4567 |
No — formatting not supported |
Numbers without a + will be rejected during import.
Results¶
After the import completes, you will see a summary:
- Imported — new contacts created
- Updated — existing contacts updated
- Skipped — rows with invalid data (e.g. missing phone, invalid format)
- Errors — rows that failed with a specific reason
Download the error report to fix and re-import rejected rows.
Limits¶
| Item | Limit |
|---|---|
| Max file size | 10 MB |
| Max contacts per import | 50,000 |
| Supported file types | .csv only |
For larger lists, split the file into multiple imports.