---
title: "Create Linked Object"
method: POST
path: "/public/v1/documents/{id}/linked-objects"
tags: ["Document Link to CRM"]
---

# Create Linked Object

`POST /public/v1/documents/{id}/linked-objects`

Create a linked object in the document.

> 🚧 
> 
> You can only link each document to each CRM once. This ensures the consistent functionality of the [two-way CRM sync](https://support.pandadoc.com/en/articles/9714877-hubspot-crm#h_3a3344e8-2a6e-4fd8-86be-0da8c121e4ac).
> 
> You can, however, link one document to several external systems.

## Path parameters

- `id` string, required

## Request body

- LinkedObjectCreateRequest
  - `provider` string, required — CRM name (lowercase). See the list of available providers: https://developers.pandadoc.com/reference/link-service#examples-of-the-most-popular-crms
  - `entity_type` string, required — Entity type. See the available entity types: https://developers.pandadoc.com/reference/link-service#examples-of-the-most-popular-crms
  - `entity_id` string, required — Entity unique identifier. The system validates if the entity exists.

## Response `201`

Created

- LinkedObjectCreateResponse
  - `id` string — Linked object identifier (link_id).
  - `provider` string — CRM name (lowercase). See the list of available providers: https://developers.pandadoc.com/reference/link-service#examples-of-the-most-popular-crms
  - `entity_type` string — Entity type. See the available entity types: https://developers.pandadoc.com/reference/link-service#examples-of-the-most-popular-crms
  - `entity_id` string — Entity unique identifier. The system validates if the entity exists.
  - `children` LinkedObjectChild[]
    - `id` string — Linked object identifier (link_id).
    - `entity_type` string — Entity type. See the available entity types: https://developers.pandadoc.com/reference/link-service#examples-of-the-most-popular-crms
    - `entity_id` string — Entity unique identifier. The system validates if the entity exists.

## Other responses

- `400` — Bad Request
- `401` — Authentication error
- `403` — Permission error
- `404` — Not found
- `409` — Conflict
- `423` — Document is locked for editing
- `429` — Too Many Requests

---

[API](https://skmtc.net/pandadoc/apis/pandadoc-public-api.md) · [All operations](https://skmtc.net/pandadoc/apis/pandadoc-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandadoc/pandadoc-public-api/versions/0c2b70be3fb0/schema)