How to Import Customer List into QuickBooks Desktop?

August 28, 2025

Import Customer List into QuickBooks Desktop

Import Customer/ Jobs from Supported File Formats directly into QuickBooks Desktop using SaasAnt Transactions (Desktop) - the #1 user-rated and Intuit-trusted bulk data automation tool built exclusively for QuickBooks.

SaasAnt Transactions (Desktop) supports QuickBooks Pro, Premier, Enterprise, and Accountant Editions.

You can download the free trial of the software directly from the SaasAnt Website. Follow this article for detailed installation instructions.

Steps for Importing Customers into QuickBooks

This guide outlines the complete process of importing data into QuickBooks Desktop, from downloading the application to reviewing the final results.

Step 1: Download, Install, and Connect Saasant

Before you can import, you need to set up the Saasant Transactions application.

  • Download: Go to the Saasant.com website and download the Saasant Transactions Desktop application.

SaasAnt Desktop Download - SaasAnt Website.png

  • Install: Run the installer and complete the installation on your computer.

  • Connect: Open the Saasant application and connect it to your QuickBooks Desktop company file by following the on-screen instructions. This will authorize Saasant to access and import data into your file.

Connect SaasAnt Desktop with QuickBooks Desktop.png

Step 2: Start the Import Process

From the Saasant home screen, you have two options to begin:

  • Click the Import button.

  • Go to the File menu and select Import.

Start Import SaasAnt Transactions Desktop.png

Step 3: Select Your Transaction Type and File

On the first screen, you will need to define what you are importing.

  • Choose Transaction/List Type: Use the dropdown menu to select the type of data you want to import here “Customer Jobs”

  • Download a Sample Template (Optional): You can download a sample CSV/spreadsheet file. This template shows you the correct column structure and formatting for a successful import.

  • Select Your File: Click Browse File to locate and select the CSV or spreadsheet file you want to import from your computer.

Browse Customer List - SaasAnt Transactions Desktop.png

Step 4: Map Your File to QuickBooks Fields

This is a critical step where you tell Saasant how the columns in your file correspond to the fields in QuickBooks.

  • Automatic Mapping: Saasant will automatically map columns from your file if their headers match the QuickBooks field names.

  • Manual Mapping: If your column names are different, you can manually select the correct QuickBooks field from the dropdown list for each of your columns.

  • Customization Options: Use advanced options to manipulate your data during the import:

    • Set value if empty: Fill in a default value if a cell in your file is blank.

    • Merge: Combine data from multiple columns into a single QuickBooks field.

    • Override: Replace existing data with new information.

  • View Mandatory Fields: Click the Show Important Fields button to see which fields are required by QuickBooks for the transaction type you are importing.

  • Save Your Mapping: You can save your mapping configuration. This creates an efficient workflow for future imports, as you won't have to map the same file format again.

Mapping Customer List - SaasAnt Transactions Desktop.png

Step 5: Review, Edit, and Configure Settings

The final screen, "Review and Import," gives you a last chance to check and modify your data before it goes into QuickBooks.

  • Review Your Data: Your data is displayed in a spreadsheet-like grid. You can review all entries for accuracy.

Review Customer List - SaasAnt Transactions Desktop.png

  • Make Final Edits: The fields in the grid are editable, allowing you to make last-minute corrections directly within Saasant.

  • Filter Data: If you have a large file, use the filter options to find and review specific lines or make bulk changes.

  • Selective Import: Use the checkboxes next to each row to select or deselect specific lines you want to import or skip.

  • Configure Import Settings: Click Import Settings to access powerful automation features:

    • Assign transaction numbers (e.g., Invoice No, Check No) from your file.

    • Specify the date format used in your file.

    • Set rules for finding and handling matching transactions already in QuickBooks.

    • Automatically create new Customers, Vendors, Products/Services, or Accounts if they don't already exist.

Import Setting - SaasAnt Transactions Desktop.png

Step 6: Send to QuickBooks and Monitor Results

Once you are satisfied with the review and settings:

  1. Click the Send to QuickBooks button to start the validation and import process.

Send Customer QuickBooks - SaasAnt Transactions Desktop.png

  1. If you need to start over, click Select file again.

  2. After the import, a results screen will appear, clearly showing which lines were successful and which failed with errors.

Success Customer List - SaasAnt Transactions Desktop.png

Step 7: Handle Errors and Finalize

The import results screen provides tools for troubleshooting and finalizing the process.

  • Fix Errors: For each failed line, an error message will explain the problem (e.g., "No account found in the specified name").

    • Click the Fix button next to the error to correct the data in the table directly.

    • After making corrections, you can attempt to re-import only the failed lines.

  • Undo Import: If there are major issues with the entire import, click the Undo button. This will safely delete all records created in QuickBooks during this specific import session.

View Logs: You can access detailed Warning and Error Logs for further analysis.

Mapping QuickBooks Fields

Customer Name*

Text (Max Length: 41 Characters)

Name of the Customer

Parent Customer

Text (Max Length: 41 Characters)

The immediate parent of the Customer.

Company Name

Text (Max Length: 41 Characters)

Name of the Company

Title

Text (Max Length: 15 Characters)

Title of the Customer.

First Name

Text (Max Length: 25 Characters)

First Name of the Customer

Middle Name

Text (Max Length: 5 Characters)

Middle Name of the Customer

Last Name

Text (Max Length: 25 Characters)

Last Name of the Customer

Currency

Text (Max Length: 64 Characters)

Currency Code for customer transactions

Customer Type

Text (Max Length: 159 Characters)

Type of the Customer

Account Number

Text (Max Length: 99 Characters)

Account Number

Opening Balance

Decimal

The open balance amount or the amount unpaid by the customer.

Open Balance Date

Date

Date of the Open Balance.

Job Title

Text (Max Length: 41 Characters)

Title of the Job

Main Phone

Text (Max Length: 21 Characters)

The telephone number in free form.

Alt. Phone

Text (Max Length: 21 Characters)

The telephone number in free form.

Main Email

Text (Max Length: 1023 Characters)

Email address.

Work Phone

Text (Max Length: 21 Characters)

The telephone number in free form.

CC Email

Text (Max Length: 1023 Characters)

Email address.

Mobile

Text (Max Length: 21 Characters)

The Mobile number in free form.

Fax

Text (Max Length: 21 Characters)

The fax machine number in free form.

Billing Address Line 1

Text (Max Length: 41 Characters)

First line of the Billing Address.

Billing Address Line 2

Text (Max Length: 41 Characters)

Second line of the Billing Address.

Billing Address Line 3

Text (Max Length: 41 Characters)

Third line of the Billing Address.

Billing Address City

Text (Max Length: 31 Characters)

City Name.

Billing Address Postal Code

Text (Max Length: 13 Characters)

Postal code (Zip code for USA and Canada)

Billing Address Country

Text (Max Length: 31 Characters)

Name of the country.

Billing Address State

Text (Max Length: 21 Characters)

Region within a country. Ex: State Name for USA, Province name for Canada.

Shipping Address Line 1

Text (Max Length: 41 Characters)

First line of the Shipping Address.

Shipping Address Line 2

Text (Max Length: 41 Characters)

Second line of the Shipping Address.

Shipping Address Line 3

Text (Max Length: 41 Characters)

Third line of the Shipping Address.

Shipping Address City

Text (Max Length: 31 Characters)

City Name for Shipping Address.

Shipping Address Postal Code

Text (Max Length: 13 Characters)

Postal code (Zip code for USA and Canada) for Shipping Address.

Shipping Address State

Text (Max Length: 21 Characters)

Region within a country. Ex: State Name for USA, Province name for Canada.

Shipping Address Country

Text (Max Length: 31 Characters)

Name of the country for Shipping Address.

Preferred Delivery Method

Text (Max Length: 31 Characters)

Preferred delivery method.

Preferred Payment Method

Text (Max Length: 31 Characters)

Preferred Payment method

Credit Limit

Decimal


Price Level

Text (Max Length: 31 Characters)

 Name of the Price Rule

Sales Rep


Name of the Sales Representative connected to this customer

Job Description

Text

Details about the job

Job Type

Text


Job Status

Text

Job Start Date

Date

Job Projected End Date

Date


Job End Date

Date


Class

Text (Max Length: 159 Characters)


Credit Card Number

Text


Expiration Month

Number

Credit Card Month of Expiry

Expiration Year

Number

Credit Card Year of Expiry

Name On Card

Text (Max Length: 41 Characters)

Name on the Credit Card

Credit Card Address

Text (Max Length: 41 Characters)


Credit Card Postal Code

Text (Max Length: 21 Characters)


Credit Limit

Decimal

Resale No

Text (Max Length: 15 Characters)

 All (*) marked fields are mandatory. 

Import Settings

A host of powerful customizations for your file data is available with Import Settings. This is available in the  Step 3: Review & Import screen or under the "Edit" Menu in the Menubar. Some of the very useful settings for lists include:

  • Action When a Matched List Found: The corresponding action will be taken if an existing list entity is found with the given name. You can choose to Show Warning/ Update existing transactions in your QuickBooks.

  • Pre-Import Validation: Validate the complete file before importing it to QuickBooks. By turning this setting ON, file rows will be imported only after cleaning up all the issues in the file. This option, however, will delay the import.

More details about the settings related to managing list import are available in this article.

FAQs

Most of us would have questions while moving data to your QuickBooks Online. Some of them for your reference below:

I made some mistakes in the Import, and my QuickBooks reports got corrupted. Is there any way to undo or revert my Import?

It is possible to undo the import completely/ partially with the Delete feature.

Does your app support taxes?

Yes. It does.

My file has some specific date format. I don't want to change the file. Will your product support all date formats?

Yes. You can select the specific date format as per your requirement in the import settings.

Do you have any sample templates?

Yes. We do have. Sample Template

What file types does SaasAnt Transactions Desktop support for importing into QuickBooks Desktop?

SaasAnt Transactions Desktop supports XLS, XLSX, XLSM, CSV, TXT, and IIF.

How do I report the issues if I am stuck?
Feel free to drop an email to
support@saasant.com 

Automated data Import / Export to QuickBooks Online
Say goodbye to the hassle of managing transactions manually
Grow exponential with Clear Financial Visibility