Skip to main content

Create customer address

POST 
/v2/customers/:lookupKey/:lookupValue/addresses

Create a new address for a specific customer with complete validation and business rule enforcement.

Key Features​

  • Flexible Customer Lookup: Create address using internal ID or external source ID
  • Complete Address Validation: Validates all address components and business rules
  • Default Address Management: Automatically handles default address assignment
  • Source System Integration: Supports external system integration with source tracking

Business Rules​

  • Customer must exist before address creation
  • Address type must be valid (delivery, invoice, etc.)
  • Postal code is required for address validation
  • Only one default address per type per customer
  • Address code must be unique within customer scope

Validation Rules​

  • Street address is required and must be non-empty
  • City, country and postal code are mandatory fields
  • Contact name fields have length restrictions
  • Email format validation when provided

Use Cases​

  • New Customer Setup: Add initial addresses during customer onboarding
  • Address Expansion: Add additional delivery or billing addresses
  • System Integration: Import addresses from external systems
  • Address Management: Create addresses through admin interfaces

Request​

Responses​

Address created successfully