# Merge two companies

Merge the secondary company into the primary contact. Related records (e.g., activities, bookings, notes) are reassigned to the primary entity. Noop if any of the companies are null. Returns a success flag with a human-readable message.

Endpoint: POST /api/v3/companies/merge
Version: 3.0.9
Security: OAuth2

## Request fields (application/json):

  - `primaryEntityId` (integer, required)
    ID of the primary entity to keep after the merge
    Example: 12345

  - `secondaryEntityId` (integer, required)
    ID of the secondary entity that will be merged into the primary entity
    Example: 67890

## Response 200 fields (application/json):

  - `success` (boolean, required)
    Indicates whether the operation was successful.
    Example: true

  - `message` (string, required)
    Additional human-readable information about the operation result.
    Example: "Contact created successfully."