---
title: "Add Container"
method: POST
path: "/v4/internationalArrivalsContainers/rm"
tags: ["International Arrivals Containers"]
---

# Add Container

`POST /v4/internationalArrivalsContainers/rm`

Create and name (with and ID or alias) a new international arrivals container to be used for manifesting a specific group of shipments. Define which carrier and shipping location the container should be linked to.
<br />
<br />Unlike the common **Containers** API, the International arrival Containers endpoint is used for Royal Mail shipments that are being imported into GB only. For shipments in these containers, a Data Solution file is generated and sent to Royal Mail, which allows them to associate the shipments in the container with the container ID of the container, for better tracking and visibility purposes.

## Request body

- AddInternationalArrivalsContainerRequest — Add International Arrivals Container Request
  - `ShippingLocationId` string, required — A unique identifier for the shipping location assigned by the system or by you (alias) from which the container is being dispatched, ensuring that all containers are correctly linked to their respective shipping points.
  - `ContainerId` string, nullable — An identifier assigned by the SAPIENT system or by you (alias) for this container associated with the shipment, important for managing cargo and logistics at scale. <br /> <br />***Note:** If not provided, then a globally unique identifier is generated and used as the Container ID.*
  - `DestinationCountryCode` string, required — An abbreviation representing the destination country to which this container will be shipped, typically following the ISO 3166-1 alpha-2 standard, for example, "US" for the United States of America.
  - `ExportDate` string, date, nullable — The date provided by the customer or automatically set by the system when the container is finalised and ready for export. If the container is finalised on a different date, then this date will be overwritten. <br /> <br />***Note:** The date must be in the YYYY-MM-DD format.*
  - `Mawb` string, nullable — A unique identifier assigned to a specific air freight shipment. If provided, it must be in the nnn-nnnnnnnn format. <br /> <br />***Note:** This number is vital for tracking and managing the shipment and must be included prior to manifesting the container to ensure that all shipments within the container are successfully manifested.*
  - `RmService` 'P' | 'E' | 'S' — Indicates the Royal Mail service associated with the shipment. <br /> <br />***Note:** This field must be populated with P.*
  - `RmProduct` 'T' | 'R' | 'O' — Indicates the Royal Mail product type for the shipment. <br /> <br />The accepted values are the following: <br /><ul><li>**T** - International Tracked</li><li>**R** - International Tracked Signed, International Signed</li><li>**O** - International Max Sort</li></ul> <br />***Note:** By default, this field is set to T.*
  - `RmContentFormat` 'G' | 'P', required — Indicates the content format of the shipments within the container. <br /> <br />The accepted values are the following: <br /><ul><li>**G** - Large letters and parcels</li><li>**P** - Small letters</li></ul>
  - `RmOeCode` string, nullable — Indicates the Royal Mail OE Code which is used for proper identification and classification of shipments destined for export. <br /> <br />***Note:** By default, this field is set to GBR.*

## Response `200`

The container has been successfully created.

- AddInternationalArrivalsContainerResponse — Add International Arrivals Container Response
  - `ContainerId` string, required — The unique identifier assigned to the newly created container. This ID is returned to the user as confirmation that the container has been successfully added to the system.
  - `Barcode` string, required — The barcode assigned to the container, which is used for tracking and managing the container in the system. This barcode is essential for scanning and identifying the container during transit.
  - `Label` string, required — The printed label for the container, which typically contains the container barcode number.

## Other responses

- `400` — Invalid request response.
- `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)