Skip to main content

Bulk company operations for enterprise data management

POST 
/v2/companies/bulk/:lookupKey

Performs bulk create, update, or upsert operations on multiple companies simultaneously. Optimized for enterprise-scale data processing with comprehensive error handling and organizational management.

Operation Types:

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

Enterprise Features:

  • Batch processing for optimal database performance
  • Duplicate detection and validation across organizational hierarchies
  • Transaction rollback on critical errors
  • Progress tracking and detailed result reporting
  • Memory-efficient processing for large enterprise datasets
  • Support for complex organizational structures

Error Handling:

  • Individual operation error tracking
  • Partial success support (some operations succeed, others fail)
  • Detailed error messages for troubleshooting
  • Validation error aggregation
  • Business rule validation (tax numbers, legal requirements)

Use Cases:

  • Company data migration from external ERP systems
  • Bulk company imports from business databases
  • Data synchronization between enterprise platforms
  • Company database maintenance and updates
  • Integration with CRM and business management systems
  • Organizational restructuring and hierarchy updates

Request​

Responses​

Bulk operation completed with detailed results