---
title: "Create Entity Link"
method: POST
path: "/entity_links"
---

# Create Entity Link

`POST /entity_links`

## Request body

- object
  - `entity_a_id` string, required — ID of object being linked
  - `entity_a_type` string, required — Type of linked object, can be "expected_payment", "return" or "payment_order"
  - `entity_b_id` string, required — ID of object being linked
  - `entity_b_type` string, required — Type of linked object, can be "expected_payment", "return" or "payment_order"
  - `metadata` object

## Response `201`

201

- object
  - `id` string
  - `object` string
  - `live_mode` boolean
  - `created_by_actor_name` string
  - `created_by_actor_id` string
  - `created_by_actor_type` string
  - `discarded_by_actor_id` unknown
  - `discarded_by_actor_type` unknown
  - `entity_a_id` string
  - `entity_a_type` string
  - `entity_b_id` string
  - `entity_b_type` string
  - `metadata` object
  - `discarded_at` unknown
  - `created_at` string
  - `updated_at` string

## Other responses

- `400` — 400

---

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