Contacts: Import & Export

Manage your WhatsApp contact database — import from CSV, export for backup, and use custom fields for segmentation.

Import contacts from CSV

CSV format

Your CSV file should have columns for:

Column	Required	Format	Example
phone	✅	International format	+972501234567
name	Optional	Full name	John Doe
email	Optional	Email address	[email protected]
labels	Optional	Comma-separated	VIP, Hebrew
notes	Optional	Free text	Met at conference
[custom field]	Optional	Any value	Premium tier

Import steps

1. Navigate to Sidebar → Contacts
2. Click "Import" (upload icon)
3. Select your CSV file
4. Map columns: Match CSV columns to Spun fields
5. Preview: Review the first 5 rows
6. Import: Click "Start Import"
7. Results: See success/error count

Import tips

• Phone format matters — use international format (+countrycode...). Spun will attempt to normalize, but explicit format is safest.
• Duplicates: If a phone number already exists, the import UPDATES the contact (doesn't create a duplicate).
• Labels: If you include a "labels" column, contacts will be auto-labeled on import.
• Batch size: Max 10,000 contacts per import.

Export contacts

1. Navigate to Sidebar → Contacts
2. Click "Export" (download icon)
3. Choose format: CSV or vCard
4. Select which fields to include
5. Apply filters if you only want a subset

What gets exported

• Phone number, name, email
• Labels
• Custom fields
• Last message date
• Contact notes

What does NOT export

• Message history (use data export in Settings → Safety for that)
• Media files

Custom fields

Add any extra data to contacts:

1. Contacts → click any contact → "Add Field"
2. Or Settings → Contacts → Custom Fields → define globally
3. Field types: Text, Number, Date, Dropdown, URL

Use cases for custom fields

• Plan tier — "Free", "Premium", "Enterprise"
• Birthday — for birthday campaigns
• Company — for B2B segmentation
• Source — "Website", "Referral", "Event"
• Account ID — link to your internal system

Custom fields are searchable and filterable in Segments.

Contact details panel

Click any contact to see:

• Profile photo + name
• Phone number (click to copy)
• Labels
• Custom fields
• Notes (free-form text, timestamped)
• Shared chats (groups they're in)
• Campaign history (past broadcasts received)
• Last interaction time

Related

• Campaigns — use imported contacts as recipients
• Labels — organize after import