---
title: "POST /api/supplychain-mappings/"
method: POST
path: "/api/supplychain-mappings/"
tags: ["Company Chains"]
---

# POST /api/supplychain-mappings/

`POST /api/supplychain-mappings/`

Create company supply chain

## Request body

- object
  - `supplyChainName` string, required
  - `facilityProcesses` object[], required
    - `facilityProcessId` string
    - `facilityProcessName` string

## Response `201`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` object, required
    - `id` string, required
    - `parentCollaborationId` 'null', nullable, required
    - `supplyChainStatus` string, required
    - `supplyChainId` string, required
    - `companyId` string, required
    - `collaborationType` string, required
    - `collaborationStatus` string, required
    - `invitedByCompanyId` string, required
    - `message` 'null', nullable, required
    - `createdByUserId` string, nullable
    - `createdByCompanyId` string, nullable
    - `createdAt` string, nullable
    - `collaboratingNodeId` string, required
    - `collaboratingSupplyChainName` string, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 7 breaking, 2 warning, 3 info
  - the response property `data/createdAt` became nullable for the status `201`
  - the response property `data/createdByCompanyId` became nullable for the status `201`
  - the response property `data/createdByUserId` became nullable for the status `201`
  - the response property `data/message` became nullable for the status `201`
  - …8 more

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/supplychain-mappings/post.md)

---

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