Addresses (Full Update)
Description
If the UUID of the Address Resource exists in the system, or no UUID is provided and an External ID exists, then an update is performed. Otherwise, the resource is created.
See the Aerial Spec for more details.
File Naming Convention
TGEN_addresses_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 |
|---|---|---|---|---|
customer | Unique Tulip identifier of the customer this address belongs to | string | Yes | |
uuid | Unique Tulip identifier of the address | Max Length: 36 | string | No |
address1 | Address line 1: street number and street name | Max Length: 64 | string | Yes |
city | City | Max Length: 32 | string | Yes |
countryCode | Country ISO code in ISO-3166-1 alpha-2 format | Max Length: 3 | string | Yes |
zoneCode | The ISO-3166-2 region code (including the country code portion) for the state/province/region | Max Length: 255 | string | No |
postCode | Postal code of the address | Max Length: 10 | string | Yes |
address2 | Address line 2 | Max Length: 64 | string | No |
externalId | Integrator provided unique identifier for the address. Typically used to map a primary key from a third party system to the Tulip resource. | Max Length: 255 | string | No |
firstName | First name associated to the address | Max Length: 64 | string | No |
lastName | Last name associated to the address | Max Length: 64 | string | No |
phone | Phone number associated to the address (E.164 standard) | Max Length: 32 | string | No |
emailAddress | Email address associated to the address | Max Length: 255 | string | No |
type | Type of address | Max Length: 255 | string | Yes |
disabled | Boolean dictating if address is disabled (true or false) | boolean | No | |
isPrimary | Boolean dictating if address is the primary address for the customer | boolean | No |
Sample CSV
See the following addresses 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.