Skip to main content
POST
/
v2
/
person-merges
Initiate Person Merge
curl --request POST \
  --url https://api.affinity.co/v2/person-merges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "primaryPersonId": 12345,
  "duplicatePersonId": 67890
}
'
{
  "taskUrl": "https://api.affinity.co/v2/tasks/person-merges/123e4567-e89b-12d3-a456-426614174000"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body for initiating a person merge

​
primaryPersonId
integer<int64>
required

The ID of the person profile that will be kept after the merge. All data from the duplicate person will be merged into this person.

Required range: 1 <= x <= 9007199254740991
Example:

12345

​
duplicatePersonId
integer<int64>
required

The ID of the person profile that will be merged and then deleted. All data from this person will be transferred to the primary person.

Required range: 1 <= x <= 9007199254740991
Example:

67890

Response

Accepted

Response body for initiating a person merge

​
taskUrl
string<uri>
required

URL to check the status of the merge task

Example:

"https://api.affinit.com/tasks/person-merges/123e4567-e89b-12d3-a456-426614174000"