---
title: "Book Collection"
method: POST
path: "/v4/collections/rm/{shipmentId}"
tags: ["Collections"]
---

# Book Collection

`POST /v4/collections/rm/{shipmentId}`

Schedule a collection of your shipments from a specified location. This endpoint is particularly useful for customers who need to return the parcel and prefer the convenience of having Royal Mail collect the items directly from their address rather than dropping them off at a postal center.
<br />
<br />***Note:** The service used to create the shipment must allow for the shipment to be collected. If no timeslot is sent in the request, then by default, the first available collection date will be selected.*

## Path parameters

- `shipmentId` string, required

## Request body

- CreateCollectionRequest — Create Collection Request
  - `SlotReservationId` string, nullable — The identifier returned from the **Get Collection Timeslots** API response. This ID corresponds to the selected time slot for the collection, ensuring that the booking is tied to the correct collection slot previously reserved by the customer.
  - `SlotDate` string, date, nullable — The collection date chosen from the list of available slots provided in the **Get Collection Timeslots** API response. This date indicates when the collection from the specified address will take place.
  - `BringMyLabel` boolean, required — A boolean parameter that indicates whether Royal Mail should bring the shipping label and any required customs declaration documents when they come to collect the shipment. <br /> <br />***Note:** By default, this field is set to false. If set to true, Royal Mail will provide the necessary documentation for the shipment during the collection.*
  - `OptOutFromRmNotifications` boolean — Indicates whether the Royal Mail collection notifications are sent to the consignee or not. <br /> <br />The accepted values are the following: <br /><ul><li>**true** — Royal Mail will not send the collection notifications to the consignee, allowing customers to send their own branded notifications instead.</li><li>**false** — Royal Mail will send the collection notifications to the consignee.</li></ul> <br />***Note:** By default, this field is set to false.*
  - `CollectionSafePlace` string, nullable — Provides details about a designated safe place location where Royal Mail can securely collect the parcel—for example, behind the bin or in the porch. This ensures that the collection can proceed smoothly if the primary location is inaccessible or no one is home.

## Response `200`

Returns the collection date and its unique identifier.

- CreateCollectionResponse — Create Collection Response
  - `CollectionOrderId` string, nullable — A unique identifier assigned to the collection order. This ID can be used for tracking and managing the collection, providing a reference point for any inquiries or follow-ups related to the scheduled collection.
  - `CollectionDate` string, date-time — The specific date on which the collection has been booked. This date confirms the arrangement made by the customer for the designated collection of their shipment.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/intersoftsapient/apis/sapient-core-api.md) · [All operations](https://skmtc.dev/intersoftsapient/apis/sapient-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intersoftsapient/sapient-core-api/revisions/3315ad0b5875/schema)