Skip to main content

Bulk customer addresses

POST 

/customers/:lookupKey/:lookupValue/addresses/bulk

Efficiently create or update multiple customer addresses in a single API request with upsert functionality and comprehensive validation.

Key Features

  • Bulk Operations: Process multiple addresses in a single request
  • Upsert Functionality: Automatically create new or update existing addresses based on code
  • Dynamic Lookup Keys: Access customers by id or sourceId
  • Address Type Management: Support for delivery, billing, and custom address types
  • Validation: Comprehensive field validation with detailed error reporting

Upsert Logic

  • Code provided + exists: Update existing address
  • Code provided + doesn't exist: Create new address with provided code
  • No code provided: Create new address with auto-generated code

Request

Responses

Customer bulk addresses - 200