Skip to main content

Bulk customer operations for data import/export

POST 
/v2/customers/bulk/:lookupKey

Performs bulk create, update, or upsert operations on multiple customers simultaneously. Optimized for high-volume data processing with comprehensive error handling and progress tracking.

Operation Types:

  • CREATE: Create new customers (fails if customer exists)
  • UPDATE: Update existing customers (fails if customer doesn't exist)
  • UPSERT: Create or update customers (handles both scenarios)

Performance Features:

  • Batch processing for optimal database performance
  • Duplicate detection and validation
  • Transaction rollback on critical errors
  • Progress tracking and detailed result reporting
  • Memory-efficient processing for large datasets

Error Handling:

  • Individual operation error tracking
  • Partial success support (some operations succeed, others fail)
  • Detailed error messages for troubleshooting
  • Validation error aggregation

Use Cases:

  • Customer data migration from external systems
  • Bulk customer imports from CSV files
  • Data synchronization between platforms
  • Customer database maintenance and updates
  • Integration with CRM systems

Request​

Responses​

Bulk operation completed with detailed results