Logo
Module: CRM

Import & Export Training Guide

Migrate customer data from spreadsheets, CSV files, and legacy CRM systems with error inspection.

13 min read
Intermediate Level
4 Core Lessons
Start Learning Now

What You Will Learn

By the end of this training module, you will be able to:

Initiate entity-specific bulk imports for Leads, Contacts, and Accounts
Download sample CSV/Excel templates with required field structures
Map spreadsheet headers to database fields with auto-matching
Inspect import jobs (/imports/:id) with real-time success and failure counters
Use the interactive JSON view modal to pinpoint validation errors on failed rows
Execute bulk data exports (/:entity/export) with preserved filter criteria

Key Concepts & Architecture

Import Bulk Guard

A secure staging interface (/:entity/import-bulk) that validates file schema, ensures entity permission checks, and guides column mapping before database ingestion.

JSON View Inspector

An interactive modal in KineCRM allowing administrators to review the raw data payload and specific validation errors of failed import rows.

Bulk Export

The automated export of filtered CRM datasets into structured CSV files for reporting or external backups.

Step-by-Step Walkthrough

Training Modules & Workflows

Follow these practical guides to master every capability of Import & Export.

Lesson 1 of 4

1. Launching Entity Bulk Imports

Upload customer spreadsheets using the dedicated entity import wizard.

1

Navigate to Bulk Import

From Leads, Contacts, or Accounts, click 'Import' or visit /:entity/import-bulk. Select your CSV or XLSX file.

2

Download Sample Template

Click 'Download Sample File' to review the pre-formatted columns and expected data formats for the selected entity.

Using the entity-specific sample template prevents header mismatches and formatting errors.
Lesson 2 of 4

2. Column Mapping & Pre-Validation

Align spreadsheet headers with KineCRM standard and custom fields.

1

Review Auto-Matched Headers

KineCRM automatically matches common headers (Name, Email, Phone, Company). Verify each mapped field.

2

Map Custom Fields

Match unique business data to your configured Custom Fields using the dropdown selectors.

3

Submit Import Job

Click 'Start Import'. The system queues the job for background batch processing to prevent browser timeouts.

Background job processing allows you to continue working elsewhere in the CRM while thousands of records are inserted.
Lesson 3 of 4

3. Monitoring Import Jobs & Debugging Failed Rows

Inspect job progress and diagnose validation failures with the JSON viewer.

1

Inspect Job Progress

Navigate to Imports (/imports) to review all historical jobs. Click into any job (/imports/:id) to view total records, processed count, success count, and failed count.

2

Review Success and Failed Tabs

Toggle between the 'Successful Rows' and 'Failed Rows' tabs to evaluate import outcome.

3

Inspect Failed Row JSON

Click the code/view icon on any failed row to open the JsonViewModal. Review the exact server error message (e.g., duplicate unique email, invalid phone format) and raw payload.

The JSON modal shows the exact database error, making it effortless to correct the original spreadsheet row.
Lesson 4 of 4

4. Executing Bulk Data Exports

Export filtered CRM lists safely for backups and offline analysis.

1

Filter Target Records

Apply desired filters in the list view (e.g., Leads created this quarter with status 'Qualified').

2

Trigger Export

Click 'Export' (/:entity/export). KineCRM packages the filtered dataset into a clean CSV file download.

Export permissions are strictly governed by user role configurations to protect sensitive customer data.

Frequently Asked Questions

Common inquiries regarding Import & Export in KineCRM.

KineCRM supports both CSV (.csv) and Microsoft Excel (.xlsx) spreadsheet formats with UTF-8 character encoding.

The 95 valid rows are successfully created in the CRM. The 5 failed rows are isolated in the 'Failed Rows' tab with detailed JSON error logs for easy correction and re-upload.

Ready to put your knowledge into practice?

Start tracking leads, accelerating sales, and managing customers with KineCRM today. No credit card required.