Skip to main content
POST
/
orgs
/
{org_id}
/
contacts
/
{contact_id}
/
merge
Merge contacts
curl --request POST \
  --url https://api.useinvent.com/orgs/{org_id}/contacts/{contact_id}/merge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_contact_ids": [
    "<string>"
  ]
}
'
{
  "merged": {
    "id": "<string>",
    "name": "<string>",
    "blocked": true,
    "unsubscribed": true,
    "is_admin": true,
    "channels": [
      {
        "id": "<string>",
        "type": "internal",
        "user_id": "<string>",
        "avatar": "<string>",
        "name": "<string>",
        "username": "<string>",
        "email": "<string>",
        "phone": "<string>",
        "country": "<string>",
        "agent": "<string>",
        "ip": "<string>",
        "language": "<string>",
        "platform_data": {},
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "link": "<string>"
      }
    ],
    "segments": [
      {
        "id": "<string>",
        "name": "<string>",
        "color": "red",
        "contacts_count": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "blocked_at": "2023-11-07T05:31:56Z",
    "unsubscribed_at": "2023-11-07T05:31:56Z",
    "unsubscribe_reason": "<string>",
    "unsubscribe_feedback": "<string>"
  },
  "merged_contact_ids": [
    "<string>"
  ]
}

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

org_id
string
required

Org ID

contact_id
string
required

Contact ID

Body

source_contact_ids
string[]

Contacts to merge into the primary. Omit to merge all auto-detected duplicates.

Required array length: 1 - 50 elements

Response

200 - application/json
merged
object
required

Schema for the contact

merged_contact_ids
string[]
required