---
title: "Link two identities (linkIdentities)"
method: POST
path: "/linkIdentities"
---

# Link two identities (linkIdentities)

`POST /linkIdentities`

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 person, and they should be represented as a single link ID.

## Request body

- ServiceRequestLinkIdentities
  - `content` LinkIdentitiesWsRequest — Represents a request to link data from one identity into another, usually across sources.
    - `linkToSource` Source, required — Tracks an identity to a particular source system and record ID.
      - `date` string — The date of the source data in ISO format (yyyy-MM-dd).
      - `name` string — Name of the data source. Must be unique across Verato.
      - `id` string — ID of an identity within the given data source.
    - `source` Source, required — Tracks an identity to a particular source system and record ID.
      - `date` string — The date of the source data in ISO format (yyyy-MM-dd).
      - `name` string — Name of the data source. Must be unique across Verato.
      - `id` string — ID of an identity within the given data source.
  - `trackingId` string

## Response `200`

Successful link identities operation.

- ServiceResponseLinkIdentities
  - `auditId` string
  - `success` boolean
  - `warnings` string[]
  - `retryableError` boolean
  - `message` string
  - `content` LinkIdentitiesWsResponse — Response to link identities request, returning the primary link ID and linkToSource information.
    - `linkId` string — link ID of the identity that received data in a link request.
    - `linkToSource` Source — Tracks an identity to a particular source system and record ID.
      - `date` string — The date of the source data in ISO format (yyyy-MM-dd).
      - `name` string — Name of the data source. Must be unique across Verato.
      - `id` string — ID of an identity within the given data source.
  - `errors` string[]
  - `trackingId` string

---

[API](https://skmtc.dev/verato/apis/verato-organization-api.md) · [All operations](https://skmtc.dev/verato/apis/verato-organization-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/verato/verato-organization-api/revisions/9ebf5a50437d/schema)