---
title: "Initiate Company Merge"
method: POST
path: "/v2/company-merges"
tags: ["Company Merges"]
---

# Initiate Company Merge

`POST /v2/company-merges`

Initiate a company merge to combine a duplicate company profile into a primary company profile.

This is an asynchronous process that will merge all data from the duplicate company into the primary company. Once the merge is initiated, you can track its progress using the returned task URL.

Requires the "Manage duplicates" [permission](/pages/external-api-v2/permissions) and organization admin role.

## Request body

- CompanyMergeRequest — Request body for initiating a company merge
  - `primaryCompanyId` integer, required — The ID of the company profile that will be kept after the merge. All data from the duplicate company will be merged into this company.
  - `duplicateCompanyId` integer, required — The ID of the company profile that will be merged and then deleted. All data from this company will be transferred to the primary company.

## Response `202`

Accepted

- CompanyMergeResponse — Response body for initiating a company merge
  - `taskUrl` string, uri, required — URL to check the status of the merge task

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `default` — Errors

---

[API](https://skmtc.net/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.net/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/versions/4c2891c31b7f/schema)