Import contacts

Most lists start life somewhere else — a CRM export, a spreadsheet, a phone’s address book. The importer takes the three shapes those produce, shows you exactly what it’s about to create before it creates anything, and never silently duplicates a number you already have.

Formats

name,primary_phone,email,company,tags,notes,timezone,language
Ada Lovelace,+442071234567,ada@example.com,Analytical Engines,vip|renewal-q4,Prefers mornings,Europe/London,en
Grace Hopper,+12025550143,grace@example.com,,lead,,America/New_York,en

Phone numbers

Numbers are validated as E.164 and stored that way. A file with local numbers (020 7123 4567) imports cleanly if you set a default country code (44); numbers that already start with + are left alone. A number that can’t be parsed is reported as an error for that row; the rest of the file still imports.

Duplicates

A contact whose primary phone already exists in your account is a duplicate and is skipped — the existing record is untouched. The same check runs within the file, so a list with the same number on two rows creates one contact. The summary tells you how many were skipped and which.

Preview, then import

From the API the same two-step shape: POST /contacts/import with the file base64-encoded, confirmed: false for the preview, then confirmed: true to run it.

curl -X POST https://api.talkif.ai/api/v1/contacts/import \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "fileContent": "Sm9obiBEb2UsKzE1NTUxMjM0NTY3",
  "format": "vcf"
}'

Next