Guides
Import Contacts
Bulk-import contacts from a CSV or JSON file into Coop.
Prepare your file
Coop accepts CSV or JSON. Here's the expected CSV format:
first_name,last_name,phone,email,organization,tags
Jane,Smith,+15551234567,jane@example.com,Acme Corp,"client,vip"
Bob,Johnson,+15559876543,bob@example.com,Widget Co,prospectPhone numbers must be in E.164 format (e.g. +15551234567). Tags are comma-separated within the field.
For JSON, use an array of objects with the same field names:
[
{
"first_name": "Jane",
"last_name": "Smith",
"phone": "+15551234567",
"email": "jane@example.com",
"organization": "Acme Corp",
"tags": ["client", "vip"]
}
]Import from the dashboard
- Go to Contacts
- Click Import
- Upload your CSV or JSON file
- Map columns to contact fields in the preview
- Click Import
The importer shows a summary of created, updated, and failed records when it finishes.
Import from the API
curl -X POST https://api.coop.example.com/api/v1/contacts/import \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "file=@contacts.csv"Export contacts
To back up your contacts or move them to another system, export as CSV or JSON from Contacts > Export, or via the API:
curl https://api.coop.example.com/api/v1/contacts/export?format=csv \
-H "Authorization: Bearer YOUR_API_KEY" \
-o contacts.csvYou can apply the same search and tag filters as the list view — the export only includes matching contacts.