Bulk Contact Import via Get Started Section

Yespo offers two methods for importing contacts: through the Contacts section and the Get started section.

For details on importing via the Contacts section, refer to this guide. This article specifically covers importing contacts through the Get started section.

📘

Note

Follow this link to learn how to prepare a contact data file for import.

Uploading File

  1. Go to the Get started → Add contacts section and click Start import.
Get started Add contacts section with Start import button
  1. Drag the file into the drop area or upload it from your computer.
File drop area for uploading a contact file

Mapping Fields

Each column of your file contains contact data type, such as emails, phones, etc. The system maps the appropriate fields or creates new ones in your Yespo account. Check the mapping correctness and make changes if necessary.

  1. Select which column to use as a unique identifier. The basic identifiers include External ID, Email, and Phone Number, but any field can serve as an identifier if desired.
📘

Note

We recommend using an external ID as the main contact identifier. The link provides use cases to help you better understand how to optimize contact identification.

  1. Select which columns to import.
Column selection for import with unique identifier dropdown
  1. Check the mapping correctness and make changes if necessary.
    • Field names — To make changes, open the dropdown list, select a field name from the existing ones, or create a new one.
Field name dropdown for mapping import columns to contact fields
📘

Note

Newly created fields are tagged as New. New contact fields are added to the default Accessorial list when your import is completed. Further, you can move them manually to another list.

  • Contact data format — To make changes, click on the format name and select the appropriate from the following options:
    • Text box
    • Text area
    • Number
    • Fractional number
    • Date
    • Date with time
Contact data format selector with available format options
📘

Note

You can change the format only for new fields

  1. Click Next.
Next button to proceed to the data validation step

Validating Data

If your contact list contains errors, the system will mark them as:

  • Red — Mistakes in emails and phone numbers
  • Orange — Warnings about inconsistencies in all other fields
Contact validation screen with red and orange error markers

Contacts with errors are not saved or updated in the system, and fields with warnings are not updated.

All fields are editable inline. You can fix them manually or skip this step by clicking Next.

📘

Note

Manual corrections in contacts will not be saved when changing the field mapping.

Click the left/right arrows to see the previous/following contact cards.

Navigation arrows for browsing through contact cards during validation

After fixing all errors and warnings in the contact card, it will be marked with a green checkmark.

Contact card marked with a green checkmark after fixing all errors

Click Next to proceed to the next step.

Advanced settings

  1. Determine which segments your contacts should fall into after import. This can be a new list segment or one or more existing ones.
Segment selection for imported contacts
  1. Select whether to import empty values. If this option is enabled, filled contact fields will be replaced by empty values from the file when updated as a result of import.
Toggle for importing empty values during contact update
  1. You can restore and update the contacts from the file by importing them.
Toggle for restoring and updating previously deleted contacts during import
  1. Click Complete import.
Complete import button to finish the import process

The import will be running in the background, and you can continue working with the system.