---
title: "Create collection"
method: POST
path: "/api/v1/collections"
tags: ["Collections"]
---

# Create collection

`POST /api/v1/collections`

## Request body

- CreateCollectionRequest
  - `label` string
  - `organizationId` string, required
  - `length` integer, required
  - `type` 'ROUTING_COLLECTION' | 'LOGISTIC_COLLECTION' | 'LABELLED_COLLECTION', required

## Response `200`

OK

- Id4n
  - `id4n` string — The ID

## Other responses

- `201` — Created
- `202` — Accepted
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method not allowed
- `406` — Not Acceptable
- `409` — Conflict
- `415` — Unsupported Media Type
- `500` — Internal Server Error

---

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