Merge two duplicate contacts

POST

/users/me/contacts/merge

Keeps the primary contact and reassigns all linked records (calls, SMS, notes, tasks, appointments) from secondary to primary, then soft-deletes the secondary. Field conflicts are resolved by mergedData — whatever you pass wins, so the client must decide ahead of time which values to keep. Irreversible: the secondary's deletedAt is set, history is preserved under the primary.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/users/me/contacts/merge' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "primaryId": "string",
    "secondaryId": "string",
    "mergedData": {
        "firstName": "string",
        "lastName": "string",
        "phoneNumber": "string",
        "email": "string",
        "address": "string",
        "notes": "string",
        "companyName": "string",
        "tags": [
            "string"
        ],
        "avatar": "string",
        "isFavorite": true,
        "source": "MOBILE",
        "lifecycleStage": "lead",
        "doNotCall": true,
        "doNotSms": true,
        "id": "string"
    }
}'

Response Example

{
    "success": true,
    "message": "string"
}

Modified at 2026-07-23 18:02:16

Find duplicate contacts

Search contacts