# Link two identities

Links two identities (typically from different sources) so they are treated
as a single entity in the LINK database. Returns the primary linkId.

Endpoint: POST /linkIdentities
Version: 2026.1.2
Security: bearerAuth

## Request fields (application/json):

  - `auditId` (string)
    Audit identifier used for tracing and governance across Verato services.

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

  - `content` (object)
    Represents a request to link data from one identity into another, usually
across sources.

  - `content.linkToSource` (object, required)
    Tracks an identity to a particular source system and record ID.

  - `content.linkToSource.date` (string)
    The date of the source data in ISO format (yyyy-MM-dd).

  - `content.linkToSource.name` (string)
    Name of the data source. Must be unique across Verato.

  - `content.linkToSource.id` (string)
    ID of an identity within the given data source.

  - `content.source` (object, required)
    Tracks an identity to a particular source system and record ID.

  - `trackingId` (string)

## Response 200 fields (application/json):

  - `auditId` (string)
    Audit identifier used for tracing and governance across Verato services.

  - `success` (boolean)

  - `unparsedJson` (string)

  - `warnings` (array)

  - `retryableError` (boolean)

  - `message` (string)

  - `content` (object)
    Response to link identities request, returning the primary linkId and
linkToSource information.

  - `content.linkId` (string)
    LINK ID of the identity that received data in a link request.

  - `content.linkToSource` (object)
    Tracks an identity to a particular source system and record ID.

  - `content.linkToSource.date` (string)
    The date of the source data in ISO format (yyyy-MM-dd).

  - `content.linkToSource.name` (string)
    Name of the data source. Must be unique across Verato.

  - `content.linkToSource.id` (string)
    ID of an identity within the given data source.

  - `errors` (array)

  - `trackingId` (string)