How do I Import Customers, Contacts, and Leads from a CSV?

Updated on March 11, 2019 12:17am by Admin

Importing data from CSV is a feature that is available in Apptivo Apps such as  Contacts, Customers, Opportunities and Leads. This feature allows you to import mass information into the system. Although it takes little effort to learn, each of these applications will work the same.
For example, we'll use the Leads App. The same process will apply all other apps. Let's quickly go through the steps.

Steps to Import Leads

  1. Log in and access Leads App from your universal navigation menu bar.
  2. Click on "More" icon and select the “Import” icon located at the app header bar.
  3. Click on "New Import" button.
  4. Click on "Browse" button and select CSV file from your computer and click on "Next".
  5. Map customer fields to respective CSV fields as shown in the below instance. Make sure to map the custom mandatory fields.
  6. After mapping the all fields as shown in the below instance hit the "Import" button to import records.
  7. You can view warning popup which alerts you for mapping common fields such as territory, segments etc.
  8. In case of mandatory fields not having values, they are added to exceptions. If error records are added to exceptions, they will be ignored and available for download later.
  9. If you want to continue, Click on "Add to exceptions and proceed" button or Click on "Back" button, to include mandatory fields.
  10. There are four validations to do import:
    • Mandatory Values - Validates mandatory value association.
    • Data Format – Validates data format issues in CSV.
    • Duplicates – Validates duplicates in CSV.
    • Reference Format – Validates the association of other objects. This will associate existing objects, if there are new objects found in CSV, you are allowed to create new objects.
  11. Click on the "Proceed" button for each step.
  12. Once the reference data completes, click on the “Proceed” button to import records. (If you want to stop the import use abort option)

  13. After proceeding, the system will display the following counts: 
    # of Records - Total count of contact records found in a file(CSV)
    # of Del Rec - Count of deleted records at the time of validating the leads
    # of Ignored - Count of ignored records which are added to the exceptions at time of mapping
  14. Now you can view the total number of records, number of deleted records and number of ignored records. Click on the "Start Import" button.
  15. Here we go, the import is done successfully and the log will display the totals of imported records, failed, and etc.
  16. The completed CSV file will be listed as shown in the image below, from where you will download the records using “Down arrow” icon found next to the columns(Total Records, Ignored Records, Failed Records)
  17. You can view the number of successful records imported, failed records and ignored records which can be downloaded as a separate CSV file for later import.


You can also map and import the custom Ref App Fields, but cannot create Ref App field values at run time during the import. You will be notified with the following alert pop-up. (For Instance: In Contacts App taking Leads as Ref App)

Ref App Support

The records will be imported, where you'll have to go to the specific record Overview page and enter the Ref App values manually.

Related Links