---
title: "Creates external TCM binding"
method: POST
path: "/tcm/external/bindings"
tags: ["TestCaseManagement"]
---

# Creates external TCM binding

`POST /tcm/external/bindings`

Creates a new external test case management binding

## Request body

- ExternalTcmBindingRequest — Request body for creating an external TCM binding
  - `external_entity_id` string, required — Unique identifier for the associated entity in the external TCM system
  - `workspace_integration_id` string, required — Unique identifier for the WorkspaceIntegration to bind to
  - `auto_sync_enabled` boolean — Per-binding automatic result synchronization setting. Defaults to false when omitted from create.
  - `external_tcm_platform` 'xray', required — Supported external test case management platforms
  - `mabl_entity_type` 'test' | 'test_case' | 'plan' | 'plan_run', required — Types of mabl entities that can be bound to external TCM.
  - `mabl_entity_id` string, required — Unique identifier for the associated mabl entity

## Response `201`

Created external TCM binding

- ExternalTcmBinding — Represents an association between an entity in an external test-case management solution, and a mabl entity
  - `external_tcm_binding_id` string — Unique identifier for the binding
  - `workspace_id` string — Unique identifier for the associated Workspace
  - `workspace_integration_id` string — Unique identifier for the associated WorkspaceIntegration
  - `external_tcm_platform` 'xray' — Supported external test case management platforms
  - `external_entity_id` string — Unique identifier for the associated entity in the external test case management solution
  - `mabl_entity_type` 'test' | 'test_case' | 'plan' | 'plan_run' — Types of mabl entities that can be bound to external TCM.
  - `mabl_entity_id` string — Unique identifier for the associated mabl entity
  - `created_time` integer — Time at which the binding was created
  - `created_by_id` string — The ID of the user who created this binding
  - `auto_sync_enabled` boolean — Per-binding automatic result synchronization setting

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unknown error

---

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