---
title: "Action: Customers (debtors)"
description: "Imports customers, matching on the identifier and creating or updating customer master data, contact details and customer-specific settings."
url: https://support.sapera.io/en/articles/615-action-customers-debtors
collection: "SyncTool"
updated: 2026-09-25
language: en
alternates: [da]
---

# Action: Customers (debtors)

Imports customers, matching on the identifier and creating or updating customer master data, contact details and customer-specific settings.

Imports customers, matching on the identifier and creating or updating customer master data, contact details and customer-specific settings.

## How to use the action

1\. Select the action in the **Action** field. 2. Point to your data source – a **file** (CSV or Excel) or a **SQL query**. 3. Map the source columns to Sapera's fields in the column mapping (see _Source fields_ below). 4. Run **Compare** to see what will be created, changed or stay unchanged – without writing to Sapera. 5. Run **Update Sapera** to perform the import.

Use the **Allow create** and **Allow update** parameters to control whether new rows are created and whether existing ones are updated.

## How matching and updating works

Each row is matched on the customer's **identifier / customer number** (Identifier). Matching customers are updated and new ones created – with master data, contact details and customer-specific settings. Direction: from file/SQL into Sapera.

## Key parameters

<table data-id="2c73525b-10e5-47fc-a69e-198cc7aefa0c" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="59f14e9c-bcdc-490c-9e56-caca7f975d8a" style="text-align: left;"><strong>Parameter</strong></p></td><td colspan="1" rowspan="1"><p data-id="e1ca28b5-09ea-41d5-a2a2-cb59dfbeb110" style="text-align: left;"><strong>Explanation</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="e5b88744-5765-4729-a2ec-daf9bc16e54e" style="text-align: left;">AllowCreate</p></td><td colspan="1" rowspan="1"><p data-id="d4707775-fc88-4af7-8c6b-8443d5d03fb2" style="text-align: left;">When enabled, customers that do not already exist are created.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="7353913b-1052-4f0a-a1d7-de183c3b1c50" style="text-align: left;">AllowUpdate</p></td><td colspan="1" rowspan="1"><p data-id="c77bb114-3299-4d27-934a-224e8f5ba5fc" style="text-align: left;">When enabled, existing customers are updated with the imported values.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="e37a1e72-04ec-4af9-ab66-a38fdd27ae71" style="text-align: left;">IsDelete</p></td><td colspan="1" rowspan="1"><p data-id="d932c3d5-f49d-42fe-a57e-efda3f48fca6" style="text-align: left;">When enabled, the matched customers are deleted instead of created or updated.</p></td></tr></tbody></table>

## Source fields

<table data-id="83fd72d1-3196-489e-81bf-f7e209c37412" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="c550c7e7-ad98-4417-bb8a-9997670fcbc2" style="text-align: left;"><strong>Field</strong></p></td><td colspan="1" rowspan="1"><p data-id="d1e05ab2-26b6-4b68-9f7d-b5ec03b967f0" style="text-align: left;"><strong>Explanation</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="36edc67d-2ce3-49a9-b9c4-df00c949cf97" style="text-align: left;">AddressLine1</p></td><td colspan="1" rowspan="1"><p data-id="7b3b5078-2a91-4bc3-944a-8decb5da7ee8" style="text-align: left;">First line of the customer's address.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="8c3036a2-4a87-4fdb-b72e-755f56019833" style="text-align: left;">AddressLine2</p></td><td colspan="1" rowspan="1"><p data-id="1d309efc-534d-4d3a-90e6-6a6bb766e122" style="text-align: left;">Second line of the customer's address.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="db185f8e-22d0-4dcd-8825-07bdd0f76b47" style="text-align: left;">Category</p></td><td colspan="1" rowspan="1"><p data-id="ac419277-9cdf-486e-80e0-f4eb73312010" style="text-align: left;">The category the customer is assigned to.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="db8d20d7-0533-4024-ac5b-fc068e03f2ce" style="text-align: left;">City</p></td><td colspan="1" rowspan="1"><p data-id="cfa28796-c323-48a5-8426-9b1997cc7e1c" style="text-align: left;">City of the customer's address.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="b861de3b-cb5c-4e30-821c-85d0da673a43" style="text-align: left;">CompanyTaxNumber</p></td><td colspan="1" rowspan="1"><p data-id="9c77a740-9109-45d1-aaa1-58ba8e2c8141" style="text-align: left;">The customer company's VAT or tax registration number.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="b1fcdec3-4f09-4180-b19b-419300089428" style="text-align: left;">Consent</p></td><td colspan="1" rowspan="1"><p data-id="9ba87011-35fb-4124-a00a-ab8a86326072" style="text-align: left;">The customer's consent for marketing and communication.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="39d75b2d-24cc-4bbc-b176-97cdddcf72df" style="text-align: left;">Country</p></td><td colspan="1" rowspan="1"><p data-id="dd6b37a3-f5af-4f8c-8364-23a3fbbd4fe6" style="text-align: left;">Country of the customer's address.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="61cb6aef-fa5d-404d-9dc8-f255be6a286b" style="text-align: left;">DefaultSalesPriceType</p></td><td colspan="1" rowspan="1"><p data-id="2ed13c81-600d-4b79-9b00-3b4e52664c08" style="text-align: left;">The default sales price type used for the customer.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="8f779513-48fd-40d6-a395-488a3db6f6cc" style="text-align: left;">Email</p></td><td colspan="1" rowspan="1"><p data-id="7ddf7aad-c8d1-4475-a94c-a25bbeffbefe" style="text-align: left;">The customer's primary e-mail address.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="6184e4e1-2977-4ece-9e4d-2525f4b77ac6" style="text-align: left;">Fax</p></td><td colspan="1" rowspan="1"><p data-id="540acd1e-652b-4e77-832a-c48c546c165e" style="text-align: left;">The customer's fax number.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="6f208cc8-7d6a-412e-af73-d81026272d82" style="text-align: left;">FirstName</p></td><td colspan="1" rowspan="1"><p data-id="1d753497-6df8-45ca-8c82-38d5d2da926c" style="text-align: left;">The customer's first name.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="fc1260c2-3d9f-45e3-a83e-939c1f02f520" style="text-align: left;">Identifier</p></td><td colspan="1" rowspan="1"><p data-id="1055d878-d702-401e-a48e-fde250ad2589" style="text-align: left;">Unique key that identifies the customer and is used to match existing records.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="f8ee0286-786f-465e-8e5f-9f084f48b9dc" style="text-align: left;">InvoiceEmail</p></td><td colspan="1" rowspan="1"><p data-id="01350920-6d32-43b4-9755-308ae277bbd1" style="text-align: left;">The e-mail address used for sending invoices to the customer.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="b6b25e47-7120-45a5-92bb-29884db63514" style="text-align: left;">LastName</p></td><td colspan="1" rowspan="1"><p data-id="704d1438-fa0b-45db-a4b2-e6e1e704d1d3" style="text-align: left;">The customer's last name.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="0774208c-de33-42fb-b605-7b1df2c74419" style="text-align: left;">Mobile</p></td><td colspan="1" rowspan="1"><p data-id="43c9fdaa-fa8c-41e3-9e97-3b8164668ac2" style="text-align: left;">The customer's mobile phone number.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="24d01902-9fa6-4055-b4f4-eba81cea8164" style="text-align: left;">Organization</p></td><td colspan="1" rowspan="1"><p data-id="415749f8-2ac1-4d6d-a470-33506e5618f4" style="text-align: left;">The organization the customer belongs to.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="7ee14cb1-e33b-413c-86ef-cfc801e8d7a2" style="text-align: left;">PaymentTerm</p></td><td colspan="1" rowspan="1"><p data-id="81cc9fcf-3d41-473d-95bc-482e0a52987e" style="text-align: left;">The payment term applied to the customer.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="048daf83-0514-4c2d-bf90-afa5dd1d3349" style="text-align: left;">Phone</p></td><td colspan="1" rowspan="1"><p data-id="1134e497-ba46-4468-b724-845d22202a61" style="text-align: left;">The customer's primary phone number.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="02526953-5dc5-436a-a8af-d08065b07957" style="text-align: left;">PreferredCommunication</p></td><td colspan="1" rowspan="1"><p data-id="dd033878-1ac9-4681-a97c-4c152035e6c1" style="text-align: left;">The customer's preferred communication channel.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="c05be4af-a3f1-4b88-93bf-8b1f434b7e55" style="text-align: left;">Sex</p></td><td colspan="1" rowspan="1"><p data-id="70fec7c8-f604-4e2b-ac8a-3c1e92d23580" style="text-align: left;">The customer's gender.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="c80833d1-f463-4639-8ffe-bf6a64bd5514" style="text-align: left;">Ssn</p></td><td colspan="1" rowspan="1"><p data-id="aa497be1-8fdc-47d6-bd14-437dfed4d4df" style="text-align: left;">The customer's social security number.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="c4db68b1-2d7b-4cab-8a5d-a0a2728649ce" style="text-align: left;">Web</p></td><td colspan="1" rowspan="1"><p data-id="bb87ef3a-4d8b-440c-b8ee-c932c154aa45" style="text-align: left;">The customer's website address.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4e543861-a813-4529-ab76-8b5034d83b99" style="text-align: left;">ZipCode</p></td><td colspan="1" rowspan="1"><p data-id="4edfecd9-5e46-438a-b538-fccaa8cb4f73" style="text-align: left;">Postal code of the customer's address.</p></td></tr></tbody></table>

* * *

See also the overview [SyncTool – actions](https://support.sapera.io/en/articles/547-synctool-handlinger.md).

* * *

**Want to know more?**

Read more in these related articles:

[

Standard parameters for all actions

The general parameters available on most SyncTool actions: step control, error handling, timeout, etc.

](https://support.sapera.io/en/articles/648.md)
