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.

This method is on the Hub surface (norbix.hub.membership) — call it from admin tooling or IaC.

These examples assume the SDK is installed and your credentials are set as environment variables — each client reads them automatically, so the constructors below take no arguments. See Install a Norbix SDK.

JavaScript / TypeScript

import { Norbix } from '@norbix.ai/ts';
const norbix = new Norbix();

const result = await norbix.hub.membership.mergeContacts({
  survivorId: 'survivor_4kX9mQvR2tYw7ZbC1dFgHj',
  mergedIds: ['item-1', 'item-2'],
});

.NET

using Norbix.Sdk;
using Norbix.Sdk.Types.Hub;

using var client = new NorbixClient();

var result = await client.Membership.MergeContactsAsync(new MergeContactsRequest
{
    SurvivorId = "survivor_4kX9mQvR2tYw7ZbC1dFgHj",
    MergedIds = new[] { "item-1", "item-2" },
});

Python

from norbix_python import NorbixHub

norbix = NorbixHub()

result = norbix.membership.merge_contacts(
    survivorId="survivor_4kX9mQvR2tYw7ZbC1dFgHj",
    mergedIds=["item-1", "item-2"],
)

Go

c, _ := norbix.New(norbix.Options{})
ctx := context.Background()

var result map[string]any
err := c.Hub.Membership.MergeContacts(ctx, map[string]any{
	"survivorId": "survivor_4kX9mQvR2tYw7ZbC1dFgHj",
	"mergedIds": []string{"item-1", "item-2"},
}, &result)

Dart / Flutter

import 'package:norbix/norbix_hub.dart';

final hub = NorbixHub();

final result = await hub.membership.mergeContacts(body: {
  'survivorId': 'survivor_4kX9mQvR2tYw7ZbC1dFgHj',
  'mergedIds': ['item-1', 'item-2'],
});

Swift

import NorbixSwift

let client = Norbix()

let result = try await client.hub.membership.mergeContacts([
    "survivorId": "survivor_4kX9mQvR2tYw7ZbC1dFgHj",
    "mergedIds": ["item-1", "item-2"],
])

Kotlin

import dev.norbix.sdk.hub.NorbixHub

val hub = NorbixHub()

val result = hub.membership.mergeContacts(mapOf(
    "survivorId" to "survivor_4kX9mQvR2tYw7ZbC1dFgHj",
    "mergedIds" to listOf("item-1", "item-2"),
))

CLI

norbix raw '/{version}/membership/users/merge' -X POST --body '{"survivorId":"survivor_4kX9mQvR2tYw7ZbC1dFgHj","mergedIds":["item-1","item-2"]}'

In the dashboard

Manage this visually in Norbix Cloud — see Membership → Users.

API reference

Full request and response for this endpoint: Merge Contacts.