---
title: "Linking incoming leads"
method: POST
path: "/api/v4/leads/unsorted/{uid}/link"
---

# Linking incoming leads

`POST /api/v4/leads/unsorted/{uid}/link`

This method allows linking an incoming lead to an existing lead.

## Path parameters

- `uid` string, required

## Request body

- object
  - `link` object
    - `entity_id` integer — The ID of the entity an incoming lead will be linked to
    - `entity_type` string — Entity type. Available options: leads
    - `metadata` object — Action metadata
      - `contact_id` integer — ID of the contact to which the contact from the unparsed one will be linked
  - `user_id` integer — The user ID on behalf of whom the binding will be performed

## Response `200`

200

- object
  - `uid` string
  - `_embedded` object
    - `leads` object[]
      - `id` integer
      - `_links` object
        - `self` object
          - `href` string
    - `contacts` unknown[]
      - unknown

## Other responses

- `400` — 400
- `401` — 401
- `404` — Incoming lead with this UID was not found

---

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