# Link two identities

Links two existing identities together without retiring either source. This is typically used when you determine that two separate source identities belong to the same real-world provider, and they should be represented as a single Verato identity cluster.

Endpoint: POST /linkIdentities
Version: 2026.1.2
Security: bearerAuth

## Request fields (application/json):

  - `auditId` (string)
    Unique audit identifier for correlating requests and responses.

  - `auditLogMap` (object)
    Map of string keys to string values.

  - `trackingId` (string)
    Optional client-defined correlation ID.

  - `content` (object)
    Link two identities together.

  - `content.linkToSource` (object, required)
    Tracks an identity back to its source system.

  - `content.linkToSource.date` (string)

  - `content.linkToSource.name` (string)
    Unique source system name across Verato.

  - `content.linkToSource.id` (string)
    Native ID of the identity within the source.

  - `content.source` (object, required)
    Tracks an identity back to its source system.

## Response 200 fields (application/json):

  - `auditId` (string)
    Unique audit identifier for correlating requests and responses.

  - `success` (boolean)
    Indicates whether the business operation succeeded.

  - `unparsedJson` (string)
    Raw response payload, for debugging or migration.

  - `warnings` (array)
    Non-fatal warnings generated by the operation.

  - `retryableError` (boolean)
    Indicates whether an error is transient and the request may be retried.

  - `message` (string)
    Human-readable status message.

  - `errors` (array)
    Error messages if success is false.

  - `trackingId` (string)
    Echo of the request trackingId, if provided.

  - `content` (object)
    Link identities response content.

  - `content.linkId` (string)

  - `content.linkToSource` (object)
    Tracks an identity back to its source system.

  - `content.linkToSource.date` (string)

  - `content.linkToSource.name` (string)
    Unique source system name across Verato.

  - `content.linkToSource.id` (string)
    Native ID of the identity within the source.