Skip to main content
Have a contact list in Excel or another app? You don’t need to add people one at a time — import the whole file from the Customers page.

Importing contacts

1

Upload your file

From Customers, click Import Contacts, then Add Import, and upload a CSV or XLSX file (up to 30 MB).Not sure how your file should look? Click Download sample CSV on this step to get a ready-made example.Your file needs a header row as the first row, and phone numbers must include the country code (for example +9198******). If a phone number already belongs to a customer, you choose what happens on the last step.
2

Map your columns

ChatFlows reads your file’s headers and suggests a mapping to contact fields automatically. Review and adjust the mapping — including your own customer fields — before continuing.
3

Set Default Values and start the import

First, choose what happens when a phone number already belongs to a customer:
  • Skip the row — the existing customer stays as it is. The row is listed as skipped. This is the default.
  • Update the existing contact — the customer is updated with the columns from your file and the default values below. Groups and labels are added, never removed.
Updating an existing customer doesn’t use any of your room for new contacts.Then set the status, source, group(s), label(s), WhatsApp channel, and assigned team member. These values are applied to every contact in this file — they cannot come from the file itself. Then choose Start Import. The import runs in the background, so large files don’t block you from continuing to use the app.If your file has more rows than you have room for, ChatFlows warns you here and imports only what fits. The extra rows are reported as failed.
Some defaults are required — the WhatsApp channel, type, status, and source must be set before you can start the import.

Tracking an import

Each import you run is listed with its status and progress. Open one to:
  • See how many rows were imported, updated, skipped, and failed.
  • Download Failed Rows CSV — a file listing the rows that failed and why.
  • Download Original File — the file you uploaded.
  • Delete a single import record, or bulk-delete several at once. This only removes the import history entry — contacts already created by that import are not deleted.
Failed row details are kept for 30 days. Download the Failed Rows CSV before they are removed.

Exporting contacts

From the Customers page, apply the filters you want — type, status, source, active, assignee, or channel — or type in the search box, then click Export to download exactly that filtered list as a file. You can also select specific contacts in the list. When contacts are selected, Export downloads only those rows.

What’s next

Managing customers

Browse, create, and edit contacts individually.

Bulk Actions & Merge

Clean up and organize contacts after a large import.
Last modified on November 17, 2026