---
title: "Create a Manifest"
method: POST
path: "/2024-09/manifests"
tags: ["Manifests"]
---

# Create a Manifest

`POST /2024-09/manifests`

Create a [manifest](https://support.easyship.com/hc/en-us/articles/4414489808525-What-Is-a-Manifest-in-Shipping).

Required authorization scope: `public.manifest:write`

## Request body

- ManifestCreate — Manifest creation.
  - `courier_id` string, uuid, required — Courier ID. Specify a courier supporting manifest creation (see [Supported Couriers and Conditions](https://support.easyship.com/hc/en-us/articles/4414489808525-What-Is-a-Manifest-in-Shipping) for details).
  - `shipment_ids` EasyshipShipmentId[] — Array of `easyship_shipment_id` values (e.g. `ESSG10006001`) — Easyship's unique shipment identifier, prefixed with `ES` and the destination country code, as returned by the Shipment API. Required for couriers that need explicit shipment selection. Any IDs that do not belong to your account are silently dropped — the manifest will be created with only the matched shipments and no error is returned. (see [Supported Couriers and Conditions](https://support.easyship.com/hc/en-us/articles/4414489808525-What-Is-a-Manifest-in-Shipping) for details). — unresolved $ref

## Response `201`

manifest successfully created

- ManifestSingle — Manifest details
  - `manifest` Manifest
    - `id` string, uuid — Manifest ID
    - `courier` object
      - `id` string, uuid — Courier ID
      - `umbrella_name` string — Human-readable name for the courier company that offers this service.
    - `created_at` string, date-time — Manifest creation date
    - `ref_number` string — Manifest reference number
    - `shipments_count` number — Number of shipments in manifest
    - `document` object — Manifest document
      - `format` 'url' — Manifest document format
      - `url` string — Manifest document URL
  - `meta` Meta
    - `request_id` string — An unique ID represent the request.

## Other responses

- `404` — courier was not found
- `422` — invalid params

---

[API](https://skmtc.net/easyship/apis/easyship-public-api.md) · [All operations](https://skmtc.net/easyship/apis/easyship-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easyship/easyship-public-api/revisions/71d737a5fcbf/schema)