Skip to Content
ContactsImport Contacts

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

ColumnRequiredNotes
phone✅ YesInclude country code (e.g. +91)
nameOptionalFalls back to phone if blank
emailOptionalMust be valid email format
Any other columnOptionalTreated 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

  1. Go to Contacts
  2. Click Import Contacts
  3. 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:

MetricDescription
CreatedNew contacts added
UpdatedExisting contacts updated
SkippedInvalid or duplicate entries
FailedRows 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, PHONE all work)