---
title: "Deduplicate Data Subjects"
method: PUT
path: "/api/consentmanager/v1/datasubjects/merge"
tags: ["Data Subjects"]
---

# Deduplicate Data Subjects

`PUT /api/consentmanager/v1/datasubjects/merge`

Use this API to merge data subject records into a primary data subject record. The transactions and profile history captured across multiple data subject identifiers will be consolidated into the primary data subject record, containing all of the data subject's information.

> 🗒 Things to Know
> 
> - Data subjects indicated in the `additionalIdentifiers` parameter value will be deleted after being merged with the `primaryIdentifier`.
> - Existing transactions for the `additionalIdentifiers` value will convert to the `primaryIdentifier`.
> - Data elements will use the most recent updated value across all of the data subject identifiers.
> - Receipts will remain under the data subject identifier from which they were generated.
> - Data subjects merged into a single profile will use the magic link of the remaining data subject.
> - Merging data subjects may affect the primary data subject's consent status. For more information about transaction and status logic, see [Universal Consent & Preference Management Transaction Types and Purpose Statuses](https://my.onetrust.com/s/article/UUID-d4ed05a9-a999-f2cb-8272-610a5817b43f).

## Request body

- ConsentPreferencesUniversalConsentPreferenceManagAdditionalIdentifierMergeRequest
  - `syncToSQL` boolean — Flag indicating whether to synchronize the merge operation to SQL database.
  - `interactionDate` string, date-time
  - `additionalIdentifiers` string[] — List of additional identifiers to be merged with the primary identifier. Must contain at least one identifier.
  - `primaryIdentifier` string, required — The primary identifier that additional identifiers will be merged into.

## Response `200`

OK - Data subjects have been successfully merged.

- string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)