Merge Contacts
curl --request POST \
  --url https://integration.getmateo.com/api/v1/contact/merge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "a": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "b": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "id": "random uuid",
  "created_at": "now()",
  "updated_at": "now()",
  "organisation_id": "random uuid",
  "full_name": "<string>",
  "fts": "<string>",
  "is_blocked": false,
  "external_id": "<string>",
  "secondary_external_id": "<string>",
  "birthday": "2023-12-25",
  "salutation": "<string>",
  "email": "<string>",
  "sms": "<string>",
  "whatsapp": "<string>",
  "instagram": "<string>",
  "facebook": "<string>",
  "display_name": "<string>",
  "google_business_messaging": "<string>",
  "address_line1": "<string>",
  "address_line2": "<string>",
  "city": "<string>",
  "zipcode": "<string>",
  "country": "<string>",
  "postal": "<string>",
  "number_of_marketing_opt_in_requests": 123,
  "latest_marketing_opt_in_request_sent_at": "<string>",
  "campaign_messages_this_month": 123,
  "whatsapp_marketing_opt_in": false,
  "sms_marketing_opt_in": false,
  "email_marketing_opt_in": false,
  "facebook_marketing_opt_in": false,
  "instagram_marketing_opt_in": false,
  "google_business_messaging_marketing_opt_in": false,
  "postal_marketing_opt_in": false,
  "whatsapp_transactional_opt_in": "legitimate_interest",
  "sms_transactional_opt_in": "legitimate_interest",
  "email_transactional_opt_in": "legitimate_interest",
  "facebook_transactional_opt_in": "legitimate_interest",
  "instagram_transactional_opt_in": "legitimate_interest",
  "google_business_messaging_transactional_opt_in": "legitimate_interest",
  "postal_transactional_opt_in": "legitimate_interest"
}

Authorizations

​
Authorization
string
header
required

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

Body

​
a
string<uuid>
required
​
b
string<uuid>
required

Response

200 - application/json

Contact merged successfully

​
id
string<uuid>
default:random uuid

Contact ID

​
created_at
string<timestamp with time zone>
default:now()

Contact creation date

​
updated_at
string<timestamp with time zone>
default:now()

Latest update

​
organisation_id
string<uuid>
default:random uuid

Organisation ID

​
full_name
string<text> | null

Name of contact

​
fts
string<tsvector> | null

Handle of contact

​
is_blocked
boolean
default:false

Is the contact blocked?

​
external_id
string<text> | null

External ID

​
secondary_external_id
string<text> | null

Secondary External ID

​
birthday
string<date> | null

Birthday of the contact

​
salutation
string<text> | null

Salutation

​
email
string<text> | null

Email of contact

​
sms
string<text> | null

SMS of contact

​
whatsapp
string<text> | null

Whatsapp Number

​
instagram
string<text> | null

Instagram

​
facebook
string<text> | null

Facebook

​
display_name
string<text> | null

Displayed name of contact in the Mateo app

​
google_business_messaging
string<text> | null

Google business messaging account of contact

​
address_line1
string<text> | null

First line of the postal address

​
address_line2
string<text> | null

Second line of the postal address

​
city
string<text> | null

City of the postal address

​
zipcode
string<text> | null

Postal code or ZIP code of the address

​
country
string<text> | null

Country of the postal address

​
postal
string<text> | null

Postal handle or identifier for the contact

​
number_of_marketing_opt_in_requests
integer

Number of marketing opt in requests

​
latest_marketing_opt_in_request_sent_at
string<timestamp with time zone> | null

Latest marketing opt in request sent at

​
campaign_messages_this_month
integer

Campaign Messages this month

​
whatsapp_marketing_opt_in
boolean
default:false

WhatsApp marketign opt in

​
sms_marketing_opt_in
boolean
default:false

SMS marketing opt in

​
email_marketing_opt_in
boolean
default:false

Email marketing opt in of contact

​
facebook_marketing_opt_in
boolean
default:false

Facebook marketing opt in

​
instagram_marketing_opt_in
boolean
default:false

Instagram marketing opt in

​
google_business_messaging_marketing_opt_in
boolean
default:false

Google business messaging marketing opt in

​
postal_marketing_opt_in
boolean
default:false

Postal marketing opt in status

​
whatsapp_transactional_opt_in
enum<string> | null

WhatsApp transactional opt in

Available options:
legitimate_interest,
contract_fulfillment,
consent_granted
​
sms_transactional_opt_in
enum<string> | null

SMS transactional opt in

Available options:
legitimate_interest,
contract_fulfillment,
consent_granted
​
email_transactional_opt_in
enum<string> | null

Email transactional opt in

Available options:
legitimate_interest,
contract_fulfillment,
consent_granted
​
facebook_transactional_opt_in
enum<string> | null

Facebook transactional opt in

Available options:
legitimate_interest,
contract_fulfillment,
consent_granted
​
instagram_transactional_opt_in
enum<string> | null

Instagram transactional opt in

Available options:
legitimate_interest,
contract_fulfillment,
consent_granted
​
google_business_messaging_transactional_opt_in
enum<string> | null

Google business messaging transactional opt in

Available options:
legitimate_interest,
contract_fulfillment,
consent_granted
​
postal_transactional_opt_in
enum<string> | null

Postal transactional opt in status

Available options:
legitimate_interest,
contract_fulfillment,
consent_granted