Create Manifest | Rendr | Documentation

The Create Store Manifest endpoint consolidates booked deliveries into carrier manifests. Rendr handles all grouping logic internally — for example, automatically splitting into separate manifest groups by carrier service — eliminating the need to manage carrier-specific splits yourself.

Manifesting is required before carrier collection. Once deliveries are booked and ready for pickup, a manifest must be submitted to the carrier to authorise collection.

Endpoint

POST {{domain}}/{{tenant_id}}/store-manifests

Authentication: Bearer token required via the Authorization header.

Request Payload

POST /{{tenant_id}}/store-manifests

1 {
2     "store_reference": "1234",
3     "ready_to_manifest": true,
4     "create_manifest_now": true,
5     "generate_order_summary": true,
6     "delivery_references": [
7         "#00001"
8     ]
9 }

Parameters

Field	Type	Required	Description
`store_id`	String	Yes*	The Rendr store identifier. Either `store_id` or `store_reference` must be provided.
`store_reference`	String	Yes*	Your internal store identifier configured during onboarding. Can be used instead of `store_id`.
`ready_to_manifest`	Boolean	No	When `true`, marks all eligible deliveries for the store as ready to be included in the manifest.
`create_manifest_now`	Boolean	Yes	When `true`, manifests are created and submitted immediately. If `false`, the manifest is returned as a draft without being submitted to the carrier.
`generate_order_summary`	Boolean	No	When `true`, an `order_summary_url` is included in the response, linking to a PDF summary of the manifest for record-keeping or printing.
`delivery_references`	Array	No	An array of your merchant-defined delivery references (as supplied at delivery creation). Use this instead of `delivery_ids` to align with your existing reference system. If omitted, all booked and unmanifested deliveries for the store are included.

Either store_id or store_reference must be provided. If both are supplied, store_id takes precedence.

Sample Response

Rendr returns an array of manifests under data. Each object represents a distinct manifest group, split automatically by carrier service.

201 Created

1 {
2     "data": [
3         {
4             "id": "demo-location_one-AUP-20250408041245402",
5             "manifest_group": "Express Post",
6             "delivery_ids": [
7                 "B6UN5bvyMWvsBVky4MPc"
8             ],
9             "external_ref": {
10                 "order_id": "TB02944895",
11                 "order_summary": {
12                     "number_of_items": 1,
13                     "total_cost": 30.53
14                 }
15             },
16             "manifest_deliveries": [
17                 {
18                     "delivery_id": "B6UN5bvyMWvsBVky4MPc",
19                     "tracking_details": {
20                         "article_id": "111JD795013401000964509"
21                     }
22                 }
23             ]
24         },
25         {
26             "id": "demo-location_one-AUP-20250408041245327",
27             "manifest_group": "Parcel Post",
28             "delivery_ids": [
29                 "fa1YSlbS5bu7yWLG6pQ3"
30             ],
31             "order_summary_url": "https://storage.rendr.delivery/manifests/demo-location_one-AUP-20250408041245327/order-summary.pdf"
32         }
33     ]
34 }

Response Fields

Field	Type	Description
`data[].id`	String	The unique identifier for the manifest.
`data[].manifest_group`	String	The carrier service group for this manifest (e.g. `Express Post`, `Parcel Post`). Rendr determines grouping automatically based on the delivery types included.
`data[].delivery_ids`	Array	The Rendr delivery IDs included in this manifest.
`data[].external_ref.order_id`	String	The carrier’s manifest or order reference number, returned once the manifest has been submitted.
`data[].external_ref.order_summary.number_of_items`	Number	Total number of parcels included in the manifest.
`data[].external_ref.order_summary.total_cost`	Number	Total shipping cost for the manifest in dollars.
`data[].manifest_deliveries`	Array	Detailed tracking information for each delivery in the manifest.
`data[].manifest_deliveries[].delivery_id`	String	The Rendr delivery ID.
`data[].manifest_deliveries[].tracking_details.article_id`	String	The carrier article ID assigned at manifest time, used for carrier-side tracking.
`data[].order_summary_url`	String	A URL linking to a PDF summary of the manifest. Only present when `generate_order_summary: true` is set in the request.