Customer Lists (Partial Update)

File Naming Convention

TGEN_customerLists_partialupdate_2025-08_<optionalSuffix>.csv

importType: partialupdate
apiVersion: 2025-08

Columns

Column Header	Description	Type	Required
`uuid`	UUID of the resource that can be expressed using a value as defined in its types.	`string`	No
`externalId`	External ID of the resource that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types.	`string`	No
`status`	Status of the customer list that can be expressed using a value as defined in its types.	`string`	No
`type`	Type of the customer list	`string`	No
`startDate`	Datetime of when the Customer List will begin to be visible in the application. When null, will always be visible before the endDate.	`mixed`	No
`endDate`	Datetime of when the Customer List will no longer be visible in the application. When null, will always be visible after the startDate.	`mixed`	No
`secondaryMetric`	A customer field or attribute to display alongside loyalty tier information on the customer list UI. Must be a top-level field on the Customer resource or an attribute.	`string`	No
`customers`	A collection of customers that can be expressed using “SET_AS_NULL” (to reset all existing values), uuids or external ids.	`array`	No
`stores`	A collection of stores that can be expressed using “SET_AS_NULL” (to reset all existing values), uuids or external ids.	`array`	No
`associates`	A collection of associates that can be expressed using “SET_AS_NULL” (to reset all existing values), uuids or external ids.	`array`	No
`localizations`	Contains the different localizations for strings associated to this resource. Resolve the best known language on the client based on available languages, not all languages are always provided.	`array`	No
`localizations[0].title`	Title of the customer list in the current language	`string`	Yes
`localizations[0].description`	Description of the customer list in the current language	`string`	No
`localizations[0].languageCode`	Language this localization pertains to, follows a pattern of 2 letters and can then have multiple other groups of 2 letters or more. Each block separated by an hyphen.	`string`	No

Sample CSV

See the following customerLists CSV sample file.

customerLists Sample 1