---
title: "Create Sample Unit for sample summary"
method: POST
path: "/samples/{samplesummaryId}/sampleunits"
tags: ["samples"]
---

# Create Sample Unit for sample summary

`POST /samples/{samplesummaryId}/sampleunits`

Create Sample Unit for sample summary

## Path parameters

- `samplesummaryId` string, uuid, required

## Request body

- SampleUnit
  - `formType` string
  - `id` string, uuid
  - `sampleSummaryFK` integer
  - `sampleUnitPK` integer
  - `sampleUnitRef` string
  - `sampleUnitType` string
  - `status` 'INIT' | 'DELIVERED' | 'PERSISTED' | 'FAILED'

## Response `200`

The sample unit was created successfully.

- SampleUnit[]
  - `formType` string
  - `id` string, uuid
  - `sampleSummaryFK` integer
  - `sampleUnitPK` integer
  - `sampleUnitRef` string
  - `sampleUnitType` string
  - `status` 'INIT' | 'DELIVERED' | 'PERSISTED' | 'FAILED'

## Other responses

- `400` — No sample unit found for sample summary.
- `401` — Authentication information is missing or invalid.
- `409` — Sample already exists for the sample summary with that sampleUnitRef
- `500` — #/components/responses/ServerError

---

[API](https://skmtc.net/office-of-national-statistics/apis/ras-rm-sample-service.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/ras-rm-sample-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/ras-rm-sample-service/revisions/6236ad7256ad/schema)