Skip to main content

Bulk contact operations for organizational data management

POST 
/v2/contacts/bulk/:lookupKey

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

Operation Types:

  • CREATE: Create new contacts (fails if contact exists)
  • UPDATE: Update existing contacts (fails if contact doesn't exist)
  • UPSERT: Create or update contacts (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 relationships

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 (company relationships, contact requirements)

Use Cases:

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

Request​

Responses​

Bulk operation completed with detailed results