Contacts
Bulk Import
Import contacts from CSV, JSON, or vCard files with validation and duplicate detection.
Import contacts in bulk by uploading a CSV, JSON, or vCard file.
CSV format
Expected columns (header names must match):
| Column | Required | Description |
|---|---|---|
name | Yes | Contact name |
primary_phone | Yes | Primary phone in E.164 format |
secondary_phones | No | Pipe-separated (|) additional phones |
email | No | Email address |
company | No | Company name |
occupation | No | Job title |
notes | No | Free-text notes (max 5,000 chars) |
tags | No | Pipe-separated (|) tags |
interests | No | Pipe-separated (|) interests |
timezone | No | IANA timezone (auto-derived from phone if omitted) |
language | No | Language code (e.g., en, es) |
JSON format
An array of contact objects with the same fields as CSV (supports both camelCase and snake_case).
vCard format
Standard vCard 4.0 files. Maps FN→name, TEL→phone, EMAIL→email, ORG→company, TITLE→occupation, NOTE→notes.
Validation
- Phone format — numbers are validated for correct E.164 format
- Duplicate detection — deduplication runs both against existing contacts and within the import file itself
defaultCountryCode— optional parameter to normalize phone numbers that lack a country code
Preview
Review the mapped data before confirming the import. See which records will be created and which will be skipped.
Import
Confirm and run the import. An import summary shows:
- Contacts created
- Contacts skipped (duplicates)
- Contacts with errors