Skip to content

Import contacts

Import an existing list from a spreadsheet or another CRM without retyping it. You upload a CSV file, check how its columns map to contact fields, and Pinlyx creates the new contacts and fills in the ones you already have.

Plan
All plans

The file is read in your browser first, so you see the columns and a preview before anything is uploaded. Each row then becomes a contact, unless it matches someone already in the workspace.

A row needs at least one identifier: an Email, a Phone, a Telegram username or an External ID. Without one there is no way to tell contacts apart, so the row is counted as unusable and skipped.

  1. Open Contacts and click Import contacts.
  2. Under Source, choose CSV file.
  3. In File, drop your CSV or click Choose file. Comma, semicolon and tab separated files all work, up to 20 MB. Download a sample file gives you a template with the expected headers.
  4. In Columns (Match your columns), check the field chosen for each column. The app guesses from the header row; change anything that looks wrong, or pick Do not import to leave a column out.
  5. In Review, optionally type a tag in Tag these contacts (for example Trade show 2026) so you can find this list later.
  6. Leave Update contacts I already have on to fill in blank fields on existing contacts, or turn it off to leave them untouched.
  7. Click Import N contacts. When it finishes, the summary shows how many were Created, Updated, Already there and Unusable.

If some rows have a different number of columns than the header, usually because of a broken quote, the Columns step warns you. They are still imported, so check them afterwards. Rows with an invalid email address or a phone number that cannot be used are listed after the import under Rows worth a look, with their line number in the file.

FieldNotes
Full name, First name, Last nameMap either a full name or the two parts.
EmailChecked for a valid address. Strongest match key.
PhoneIgnored with a warning if it cannot be used as a number.
Telegram usernameWith or without the @ or a t.me/ link.
Company, Country, CityCopied to the contact’s business details.
NotesCopied to the contact’s notes.
External IDThe person’s ID in the system the file came from.

A row with a Telegram username becomes a Telegram contact. A row without one is saved as a customer record and appears in the Customers view of Contacts.

Each row is compared with the contacts already in your workspace, including your teammates’ contacts, in this order: email, external ID, Telegram username, phone. The first match wins.

  • With Update contacts I already have on, a matched contact only gets the fields that were empty. Nothing you already entered is overwritten.
  • With it off, matched contacts are left as they are and counted as Already there.
  • The same person appearing twice inside one file is created once.
  • The tag from Tag these contacts is added to every contact in the file, new or matched, so the tag always means “this list”.

The same Import contacts window can also pull people from a connected account instead of a file:

  • Telegram imports recent one-to-one chats from your account. Pick the account and a History window (days); chats older than that are skipped. Secret chats and media are not imported.
  • X imports the people you have talked with in your X direct messages.

Both need the account to be connected first. See Channels.

  • Imported contacts land in the Contacts list. To move them to another board afterwards, see Pipelines.
  • A file with a header row and one person per line works best. Very large files are sent in batches automatically, with a progress bar.
  • Excel exports with semicolons and files with a UTF-8 byte order mark are read correctly.
  • To create contacts from your own system continuously, use the API instead: Sync contacts.