---
title: "POST /fragments/{fragmentGroupId}"
method: POST
path: "/fragments/{fragmentGroupId}"
---

# POST /fragments/{fragmentGroupId}

`POST /fragments/{fragmentGroupId}`

This endpoint stages a fragment for outbound delivery.

## Path parameters

- `fragmentGroupId` string, required — A unique ID for a group of fragments on Stedi. Stedi creates a new fragment group if one does not exist with the specified ID.

## Headers

- `Idempotency-Key` string — A unique string to identify this request to the server. The key can be up to 255 characters. You can safely retry requests with the same idempotency key within 24 hours of making the first request. This prevents sending duplicate data to your trading partners in case of network errors or other intermittent failures. [Learn more](https://www.stedi.com/docs/api-reference/index#idempotency-keys).

## Request body

- CreateOutboundFragmentRequestContent
  - `guideId` string, required — The ID of the Stedi guide for the outbound transaction setting. The guide must be configured to use fragments. You can find this ID on the **Guides** page in the Stedi portal.
  - `fragment` unknown, required
  - `mappingId` string — Specify a mapping id to transform the fragment to Stedi's Guide JSON format.

## Response `201`

CreateOutboundFragment 201 response

- CreateOutboundFragmentResponseContent
  - `fragmentGroupId` string, required — The fragment group ID where you created and added the fragment.
  - `createdAt` string, date-time, required — The time Stedi created the fragment.
  - `fragmentId` string, required — A unique ID for the fragment Stedi created within the fragment group.

## Other responses

- `400` — BadRequestException 400 response
- `401` — UnauthorizedException 401 response
- `403` — AccessDeniedException 403 response
- `404` — ResourceNotFoundException 404 response
- `409` — ResourceUnderChangeException 409 response
- `422` — UnprocessableEntityException 422 response
- `429` — ThrottlingException 429 response
- `500` — ServiceException 500 response
- `503` — ServiceUnavailableException 503 response
- `504` — GatewayTimeoutException 504 response

---

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