Merge Contacts

Merge contacts.

A contact (user) is a person in your project's membership directory, with one or more linked logins (identities). Membership manages their profile, identities, roles, and lifecycle.

Merges the contacts.

This action is destructive or irreversible. Make sure you target the right item and confirm before running it.

Merge contacts

post

Authorizations

HTTPRequired

JWT Bearer Authorization

Path parameters

VersionstringRequired

The CodeMash API version used to fetch data from the API. If not specified, the last version will be used. E.g.: v3

Body

Merge contacts

correlationIdstringOptional

CorrelationId for each request

cultureCodestringOptional

Specify culture code when your response from the API should be localised. E.g.: en

timeZoneIdstringOptional

TimeZone

versionstringRequired

The CodeMash API version used to fetch data from the API. If not specified, the last version will be used. E.g.: v3

envstringOptional

Target environment for this request (e.g. TEST, STAGING). Optional — when omitted the request runs against PROD. Can be passed in a header as norbix-env.

projectIdstringRequired

ID of your project. Can be passed in a header as norbix-project-id.

survivorIdstring · nullableRequired

The contact id (ct_…) that will remain after the merge (the survivor).

mergedIdsstring[]Required

The contact ids (ct_…) to merge into the survivor and archive. At least one.

Responses

200

Success

application/json

EmptyResponse

post/{version}/membership/users/merge

POST /{version}/membership/users/merge HTTP/1.1
Host: hub.norbix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 155

{
  "survivorId": "text",
  "mergedIds": [
    "text"
  ],
  "projectId": "text",
  "env": "text",
  "cultureCode": "text",
  "timeZoneId": "text",
  "correlationId": "text",
  "version": "text"
}

200

Success

{
  "success": {
    "responseStatus": {
      "isSuccess": true
    }
  },
  "responseStatus": {
    "isSuccess": true
  }
}

In Cloud

Manage this visually in Cloud — see Membership → Users.

Use it from code

Every Norbix SDK exposes this endpoint as a method — see Merge Contacts in the SDK reference, with examples in every language.