---
title: "Create external TCM bindings in bulk"
method: POST
path: "/tcm/external/bindings/bulk"
tags: ["TestCaseManagement"]
---

# Create external TCM bindings in bulk

`POST /tcm/external/bindings/bulk`

Creates multiple external test case management bindings in a single operation

## Request body

- BulkExternalTcmBindingOperationRequest — Request body for bulk creating or deleting external TCM bindings
  - `workspace_integration_id` string, required — Unique identifier for the associated WorkspaceIntegration
  - `external_tcm_platform` 'xray', required — Supported external test case management platforms
  - `bindings` ExternalTcmBindingBase[], required — The list of external TCM bindings to create or delete
    - `external_entity_id` string, required — Unique identifier for the associated entity in the external test case management solution
    - `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 — Unique identifier for the associated mabl entity

## Response `200`

Bulk create results

- BulkExternalTcmBindingOperationResults
  - `results` BulkExternalTcmBindingOperationResult[] — Results of the operation
    - `status` 'success' | 'failure' — Status of a bulk operation result
    - `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
    - `error` BindingOperationResultError — Error details if the operation failed
      - `message` string — Error message
      - `status` integer — HTTP status code

## 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)