Coupons (Full Update)
Description
Upsert a coupon
See the Aerial Spec for more details.
File Naming Convention
TGEN_coupons_fullupdate_2026-08_<optionalSuffix>.csv
importType:fullupdateapiVersion:2026-08
Columns
Nested object fields are flattened into columns using dot notation (parent.child). Array fields are flattened using zero-based index notation, one element per column (field[0], field[1], and so on).
Note: A whole array cannot be passed in a single column: a literal value such as ['value-1','value-2'] will be rejected. To import multiple array elements, add one indexed column per element. Rows in the table below with type array describe the field as a whole and are not valid CSV column headers.
| Column Header | Description | Key Information | Type | Required |
|---|---|---|---|---|
uuid | The UUID of the coupon | string | No | |
code | The coupon code | string | Yes | |
localizedNames | Pairs of localized coupon name with associated language ID | Not a CSV column header. Pass each array element in its own indexed column (localizedNames[0], localizedNames[1], and so on). | array | Yes |
localizedNames[0] | Array element | mixed | No | |
localizedNames[0].name | The localized coupon name | string | Yes | |
localizedNames[0].languageId | Language identifier tied to Coupon name language (1 for english) | Min: 0 | integer | No |
localizedNames[0].languageCode | Code identifier for this language (ISO 639-1) | string | No | |
isEnabled | Boolean dictating if the coupon is enabled or not | boolean | No | |
countryUuid | The country the coupon is valid for | string | No | |
storeUuid | The store the coupon is valid for | string | No |
Sample CSV
See the following coupons CSV sample file.
Note: The sample CSV may contain sample ID fields which reference other resources that do not match the data in your environment.