Documentation version
ReferenceApplies to 1.0.0

External ID update-or-create behavior

Use a source-system identifier to update known Locations and create genuinely new ones.

External ID is designed for repeatable integrations where a CSV may contain a mix of existing and new Locations.

Existing match

When an incoming row’s External ID matches the corresponding existing Location, the import can update that record according to the mapped fields.

New ID

When the External ID does not match an existing Location, the import can create a new record.

Governance

External IDs should be unique and stable. Do not change an ID simply because a Location name changes, and do not assign the same ID to two physical places.

Preview

Always verify create/update counts in the validation preview before confirming a repeat import.