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

# Initiate Person Merge

`POST /v2/person-merges`

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

This is an asynchronous process that will merge all data from the duplicate person into the primary person. 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

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

## Response `202`

Accepted

- PersonMergeResponse — Response body for initiating a person 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)