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_2025-08_<optionalSuffix>.csv
importType:fullupdateapiVersion:2025-08
Columns
| 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.