Customers and CRM · how to

Map, review, and run a contact import

Map source columns, preview identity and consent risks row by row, choose overwrite and automation policies, and execute a controlled contact import.

3 min readUpdated August 12, 2026
For
Owner, Admin, Member
Availability
Your current plan and entitlements
Product evidence
WRKZY · reviewed August 12, 2026
Editorial review
WRKZY Editorial
Before you begin
  • A cleaned source file with one contact per row
  • Approved mappings for identity, consent, owner, tags, and custom fields
  • A duplicate-handling decision and expected row count
  • Authority to create or update the represented customer records
Import contacts as a controlled data changeRead the transcript

Upload and check automatic mapping

  1. Open Contacts → Import contacts and select the approved CSV or XLSX file.
  2. Confirm WRKZY detected the intended header row. At least Phone or Email must be mapped.
  3. Open Review field mapping. A source column can map to only one destination.
  4. Review Identity, Core profile, Relationship and segmentation, Consent, and Custom-field groups.
  5. Inspect ignored columns. Map a valid existing field, create a governed text field, or deliberately leave the column out.

Save a reusable import recipe only when future files use the same meaning—not merely the same column names. Recipes preserve mapping, relationship, overwrite, and automation decisions.

Choose execution policy

Import controls
ControlDecision
Add onlyExisting phone or email matches are skipped
Update matching and add newMatching contacts can receive approved mapped changes
Default ownerAssign accountability to newly imported contacts, or leave them unowned intentionally
Create missing companies or listsCreate referenced records, or skip rows whose relationship target is unknown
Overwrite groupsDecide whether mapped file values can replace identity, company, consent, or other current data
Automation policyRun automations or pause them for the import

Review the row plan

Use the filters for Ready, Updates, Identity conflicts, Invalid identity, Consent gaps, Duplicate, Missing company, Missing list, and Skipped. WRKZY shows an outcome preview for selected rows, including WhatsApp reachability, email reachability, and consent gaps.

  1. Fix safe source errors inline when the correction is unambiguous.
  2. Deselect any row whose outcome needs business review.
  3. Resolve in-file duplicates before execution.
  4. If selected rows claim consent, confirm the consent attestation only after reviewing the evidence columns.
  5. For runs above 250 selected rows with automations enabled, reconsider whether downstream volume is intended.

Run and verify

Choose Import selected contacts only when the selected importable count matches expectation. Keep the page open until WRKZY reports Imported, Updated, Skipped, Invalid, Failed, Duplicate, company links, and list memberships.

Open Import history immediately after the run. Confirm the file name, total and selected rows, consent attestation, automation dispatch status, and a sample of created and updated contacts.

Recovery

Do not upload the same file again to repair a partially understood result. Download the relevant exception set, correct only failed or skipped source rows, and use a new controlled run. If the run itself was wrong and the undo window is open, an authorized creator, owner, or admin can undo it. Undo archives new contacts, restores imported changes, and removes imported notes and memberships while preserving later concurrent edits; external automation effects remain.

Safe execution
  • Phone or email mapping confirmed
  • No source column mapped twice
  • Overwrite and relationship policies reviewed
  • Only intended rows selected
  • Consent attestation supported
  • Results opened in Import history
Was this guide useful?

Choose an answer. No message text or personal information is collected.

Still need help?

Contact WRKZY support with the workspace name and a safe, redacted example.

Contact support about this guide