ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APIContactsMerge Duplicate Contacts

Merge Duplicate Contacts

Merges duplicate contacts into a primary contact. Reassigns deals, conversations, tags, and notes to the primary record, soft-deletes duplicates with merged_into_id, and writes an audit log.

POST/api/v1/contacts/merge

Request Body Schema

application/json
primary_contact_iduuidrequired

UUID of the contact to keep

Example:c1111111-2222-3333-4444-555555555555
duplicate_contact_idsarray<uuid>required

List of duplicate contact UUIDs to merge into primary

Example:["c2222222-3333-4444-5555-666666666666"]

Response Payload

200 OKapplication/json
statusstring

"1" = Success, "0" = Failure.

messageobject

The response data payload.

Code Snippets & Examples

1curl -X POST "https://app.chatofy.in/api/v1/contacts/merge" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"primary_contact_id":"c1111111-2222-3333-4444-555555555555","duplicate_contact_ids":["c2222222-3333-4444-5555-666666666666"]}'

Was this endpoint guide helpful?

Previous Endpoint
List Duplicate Contacts
Next Endpoint
CSV Import Pre-flight Preview
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X POST "https://app.chatofy.in/api/v1/contacts/merge" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"primary_contact_id":"c1111111-2222-3333-4444-555555555555","duplicate_contact_ids":["c2222222-3333-4444-5555-666666666666"]}'
200 OKapplication/json
1{
2 "success": true,
3 "data": {
4 "primary_contact": {
5 "id": "c1111111-2222-3333-4444-555555555555",
6 "phone_number": "919876543210",
7 "first_name": "Priya",
8 "last_name": "Sharma",
9 "updated_at": "2026-10-26T22:15:00+05:30"
10 },
11 "merged_count": 1,
12 "merged_ids": [
13 "c2222222-3333-4444-5555-666666666666"
14 ]
15 },
16 "message": "Successfully merged 1 contact(s) into primary contact"
17}