Merging Contacts

Endpoint

PATCH /contacts/merge

Description

Merges a list of contacts into a single contact. All contacts must be connected to the current account. All contact info (i.e. id, wallet(s), tags, discord, email, phone number, etc...) will be merged.

Conflicting information (ex: id, conflicting email addresses, etc...) will be solved by overwriting the contact of lower priority with the contact info of higher priority. Priority is assigned by the order in which the contacts are provided in the contactIds parameter, with contacts of higher priority coming first.

Parameters

Parameter	Type	Description
contactIds	array of type string	List of at least two ids of contacts to be merged

• Note: The priority of a contact is determined by the order of the contact ids, with higher priority contacts coming first.

Returns

Status Code	Description
200	Contacts successfully merged
400	contactIds is not an array of at least 2 strings
404	One of the provided contact ids is invalid and/or doesn't belong to the current account

Examples

Given the following contacts currently exist:

{
	id: "0"
	email:  "[e-mail]"
},
{
	id: "1"
	phoneNumber:  "[phone]"
	discordUsername:  "example#0000"
},
{
	id: "2"
	email:  "[e-mail]"
	phoneNumber:  "[phone]"
	discordUsername:  "example2#0001"
}

Example 1:

{
	"contactIds": ["0", "1"]
}

Results in the contact:

{
	id: "0"
	email:  "[e-mail]"
	phoneNumber  "[phone]"
	discordUsername:  "example#0000"
}

Example 2:

{
	"contactIds": ["0", "1", "2"]
}

Results in the contact:

{
	id: "0"
	email:  "[e-mail]"
	phoneNumber  "[phone]"
	discordUsername:  "example#0000"
}

Example 3:

{
	"contactIds": ["2", "1", "0"]
}

Results in the contact:

{
	id: "2"
	email:  "[e-mail]"
	phoneNumber:  "[phone]"
	discordUsername:  "example2#0001"
}

Example 4:

{
	"contactIds": ["1", "0", "2"]
}

Results in the contact:

{
	id: "1"
	email:  "[e-mail]"
	phoneNumber:  "[phone]"
	discordUsername:  "example#0000"
}