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.
How it works
Section titled “How it works”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.
Import a CSV file
Section titled “Import a CSV file”- Open Contacts and click Import contacts.
- Under Source, choose CSV file.
- 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.
- 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.
- In Review, optionally type a tag in Tag these contacts (for example Trade show 2026) so you can find this list later.
- Leave Update contacts I already have on to fill in blank fields on existing contacts, or turn it off to leave them untouched.
- 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.
Fields you can map
Section titled “Fields you can map”| Field | Notes |
|---|---|
| Full name, First name, Last name | Map either a full name or the two parts. |
| Checked for a valid address. Strongest match key. | |
| Phone | Ignored with a warning if it cannot be used as a number. |
| Telegram username | With or without the @ or a t.me/ link. |
| Company, Country, City | Copied to the contact’s business details. |
| Notes | Copied to the contact’s notes. |
| External ID | The 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.
How duplicates are handled
Section titled “How duplicates are handled”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”.
Import from Telegram or X
Section titled “Import from Telegram or X”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.
Good to know
Section titled “Good to know”- 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.