Creates or updates multiple companies in a single request. This endpoint processes up to 100 companies
and returns detailed results for each operation, including successes and failures.

How It Works

Each company in the batch is processed independently:

• If the company exists (based on identifiers), it will be updated
• If the company doesn't exist, it will be created
• Failed operations don't stop the processing of other companies

Request Format

Send an array of company objects (max 100) in the companies field. Each company object follows
the same structure as the single upsert endpoint.

Response Format

The response includes:

• Statistics: Total processed, created, updated, and failed counts
• Detailed Results: Array with status and details for each company (by index)

Status Values

Each company in the results can have one of these statuses:

• created: Company was successfully created
• updated: Company was successfully updated
• failed: Operation failed (see error_code and error_message)

Error Handling

Errors for individual companies don't affect other companies in the batch. The response will include:

• error_code: The specific error code (e.g., "company_conflicting_identifiers")
• error_message: Human-readable error description