Skip to main content
POST
/
v1
/
contacts
/
merge
Merge contacts
curl --request POST \
  --url https://api.prod.getdex.com/v1/contacts/merge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactIds": [
    [
      "<string>"
    ]
  ]
}
'
{
  "error": true,
  "data": {
    "mergedContactIds": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ]
  }
}

​
Use cases

  • Deduplicate contacts that were imported from multiple sources
  • Combine a manually-created contact with one synced from email
  • Clean up after a bulk import that created duplicates
The secondary contacts will be permanently deleted after the merge. Their notes, tags, and group memberships are transferred to the primary contact.

Authorizations

​
Authorization
string
header
required

Use your Dex API key (e.g. dex_abc123...) as the Bearer token.

Body

application/json
​
contactIds
string[][]
required
Minimum array length: 1
Minimum array length: 2

Response

Successful response

​
error
boolean
required
​
data
object
required