---
title: "Create Scheduled Export of Duplicate Data Subjects"
method: POST
path: "/api/consentmanager/v1/scheduled-jobs/merge-request"
tags: ["Deduplicate Data Subjects"]
---

# Create Scheduled Export of Duplicate Data Subjects

`POST /api/consentmanager/v1/scheduled-jobs/merge-request`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/consentmanager/v1/scheduled-jobs/merge-request`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `CONSENT`

Use this API to create a scheduled export of duplicate data subjects.

> 🗒 Things to Know
> 
> - Once the scheduled export is created, you can retrieve the file using the [Generate Export of Duplicate Data Subjects](https://developer.onetrust.com/onetrust/reference/exportduplicatedatasubject) API.

## Request body

- ConsentPreferencesUniversalConsentPreferenceManagMergeDSRequestDto
  - `mergeRequestId` string, uuid, required: Unique identifier of the merge request
  - `mergeRequestName` string, required: Name of the merge request which uniquely identifies the job
  - `triggerTime` string, date-time: The time at which triggers the job to find duplicate Data Subjects
  - `jobFrequency` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY' | 'CUSTOM', required: Frequency at which the job runs
  - `jobStatus` 'PENDING' | 'COMPLETED' | 'IN_PROGRESS' | 'MERGE_REPORT_IN_PROGRESS' | 'FAILED' | 'CANCELLED': Current status of the job
  - `mergeCondition` 'ANY' | 'ALL', required: Condition used to apply between Data Subject Elements when identifying duplicates
  - `totalDataSubjectCount` integer: Total number of Data Subjects that match the given conditions
  - `duplicateDataSubjectCount` integer: Number of duplicate Data Subjects found based on the specified conditions
  - `customDataElementNames` string[], required: List of Data Element names for which the merge condition will be applied

## Response `200`

OK - Successfully created scheduled export

- 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.dev/onetrust/apis/consent-preferences-universal-consent-preference-management.md) - [All operations](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management/revisions/fe4a0697ec9d?raw)
