---
title: "Add Container"
method: POST
path: "/v4/containers"
tags: ["Containers"]
---

# Add Container

`POST /v4/containers`

Create and name (with and ID or alias) a new container to be used for manifesting a specific group of shipments. Define which carrier and shipping location the container should be linked to.

## Request body

- AddContainerRequest — Add Container Request
  - `CarrierCode` string, required — Carrier Code
  - `ShippingLocationId` string, required — Shipping Location Id <br />SAPIENT Shipping Location Id (assigned by SAPIENT) or Alias (assigned by you) of the shipping location that this container is for.
  - `ContainerId` string, nullable — Container Id <br />The Container Name/Alias for this container <br />Defaults to a globally unique identifier.

## Response `200`

The container has been successfully created.

- AddContainerResponse — Container
  - `ContainerId` string, required — Container Id <br />The Container Identifier
  - `CreatedDateUtc` string, date-time, required — Created Date UTC
  - `CreatedDate` string, date-time, required — Created Date
  - `CarrierCode` string, required — Carrier Code <br />The carrier that the container is for.
  - `ShippingLocationId` string, required — Shipping Location <br />The shipping location name/alias that this container is for.

## 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)