Import Contacts
Import thousands of contacts at once using a CSV file.
Step 1: Prepare Your CSV
Your CSV must have at minimum a phone column. Recommended columns:
name,phone,email,city,tag
John Doe,+919876543210,john@example.com,Mumbai,vip
Jane Smith,+918765432109,jane@example.com,Delhi,Column Rules
| Column | Required | Notes |
|---|---|---|
phone | ✅ Yes | Include country code (e.g. +91) |
name | Optional | Falls back to phone if blank |
email | Optional | Must be valid email format |
| Any other column | Optional | Treated as custom attribute |
Phone format: Include the
+and country code. Numbers without country code may fail to match existing contacts.
Step 2: Open Import Dialog
- Go to Contacts
- Click Import Contacts
- Click Choose File and select your CSV
Step 3: Review and Import
The import is automatic:
- New contacts are created
- Existing contacts (matched by phone) are updated
- Invalid rows (bad phone format, missing required field) are skipped
- Previously deleted contacts are restored if they match by phone
Step 4: View Results
After the import completes, a summary appears:
| Metric | Description |
|---|---|
| Created | New contacts added |
| Updated | Existing contacts updated |
| Skipped | Invalid or duplicate entries |
| Failed | Rows that couldn’t be processed |
Tips
- Always include country codes in phone numbers
- Use UTF-8 encoding for your CSV (especially for non-English names)
- Maximum recommended import size: 50,000 rows per file
- Headers are case-insensitive (
Phone,phone,PHONEall work)