--- title: "Action: Actors" description: "Imports actors (companies and persons) for a chosen role, matching on the identifier and creating or updating actor master data and contact details." url: https://support.sapera.io/en/articles/614-action-actors collection: "SyncTool" updated: 2026-09-25 language: en alternates: [da] --- # Action: Actors Imports actors (companies and persons) for a chosen role, matching on the identifier and creating or updating actor master data and contact details. Imports actors (companies and persons) for a chosen role, matching on the identifier and creating or updating actor master data and contact details. ## 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 actor's **identifier**. The actors are imported into a **chosen role** (e.g. customer, supplier or contact) – the role is selected for the action. - Matching actors are updated and new ones created, with master data and contact details. Direction: from file/SQL into Sapera. ## Key parameters

Parameter	Explanation
AllowCreate	When enabled, actors that do not already exist are created.
AllowUpdate	When enabled, existing actors are updated with the imported values.
IdentifierField	The actor field used to match incoming rows against existing actors instead of the default identifier.
IsDelete	When enabled, the matched actors are deleted instead of created or updated.
Role	The role system name the imported actors are assigned to and whose fields become available as columns.

## Source fields

Field	Explanation
AddressLine1	First line of the actor's address.
AddressLine2	Second line of the actor's address.
City	City of the actor's address.
Country	Country of the actor's address.
Email	The actor's primary e-mail address.
Fax	The actor's fax number.
FirstName	The person's first name.
Identifier	Unique key that identifies the actor and is used to match existing records.
InvoiceEmail	The e-mail address used for sending invoices to the actor.
LastName	The person's last name.
Mobile	The actor's mobile phone number.
Phone	The actor's primary phone number.
Web	The actor's website address.
ZipCode	Postal code of the actor's address.

* * * 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)