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

# Add Container

`POST /v4/containers`

Create and add new shipping containers to the system for manifesting specific group of shipments. With this endpoint, the system processes the creation of the specified container and associates it with a given carrier and shipping location. This API streamlines logistics management and helps ensure that container data is accurately maintained for shipping operations.

## Request body

- AddContainerRequest — Add Container Request
  - `CarrierCode` string, required — A unique identifier for the shipping carrier for which a container is being created. This code is alphanumeric and helps in identifying the specific carrier linked to the container.
  - `ShippingLocationId` string, required — A unique identifier for the shipping location assigned by the system (**ShippingLocationId**) or by you (**LocationAlias**) where the container will be stored or from which it will be dispatched. This parameter links the new container to a specific physical location, aiding in inventory management and logistical operations.
  - `ContainerId` string, nullable — A unique identifier for the new container being created. This ID is used to reference and manage the specific container within the PRO SHIPPING system, facilitating tracking and operational oversight. <br /> <br />***Note**: If this information is not provided, then by default, this field is set to the globally unique identifier (GUID).*

## Response `200`

The container has been successfully created.

- AddContainerResponse — Container
  - `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.
  - `CreatedDateUtc` string, date-time, required — A timestamp indicating when the container was created in the system, formatted in Coordinated Universal Time (UTC). This information helps users to track the age and relevance of their container records.
  - `CreatedDate` string, date-time, required — The specific date on which the container was created. This provides a clear reference for users to understand when the container was added to the system.
  - `CarrierCode` string, required — A unique identifier for the shipping carrier associated with the new container. This code is alphanumeric and helps confirming which carrier will handle the shipping and logistics for that container.
  - `ShippingLocationId` string, required — The unique identifier assigned by the user (alias) to the shipping location linked to the newly added container, providing context about where the container is stored or from where it will be despatched.

## Other responses

- `400` — Invalid request response.
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/proshipping/apis/pro-shipping-core-api.md) · [All operations](https://skmtc.dev/proshipping/apis/pro-shipping-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/proshipping/pro-shipping-core-api/revisions/ae5fc5e90109/schema)