Merge
[POST] .../v1/client/merge
Merges a duplicate CRM client into a target client. Consolidate duplicate CRM clients after selecting the duplicate source client and the target client that should remain active. The method moves source links in leads, deals, tickets and tasks to the target client, writes merge history with the operator and comment, soft-deletes the source client, recalculates target client sentiment, sends the ClientMerged webhook and returns row_affected with target and source ids. The request body is required; source_client_id and target_client_id must be positive, must be different and both clients must exist and not be deleted. The caller must have CRM client merge permission; missing body, invalid ids, equal source and target, denied access, missing source or target client, storage errors, sentiment recalculation errors are returned as HTTP 200 ErrorResult.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| comment | String | Optional | Merge operation comment. |
| source_client_id | Int64 | Required | Source client ID for the duplicate client. |
| target_client_id | Int64 | Required | Target client ID. |
Request Example
{
"source_client_id": 126,
"target_client_id": 125,
"comment": "Merged duplicate clients after import"
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Update | Update operation result. |
Response Example
{
"ok": true,
"result": {
"row_affected": 1,
"ids": [
125,
126
]
}
}