---
title: "Add a tracking code to order items"
method: POST
path: "/shipments/add_tracking_code"
tags: ["Shipments"]
---

# Add a tracking code to order items

`POST /shipments/add_tracking_code`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/shipments/add_tracking_code`
- Auth: OAuth 2
  - Authorization code: `https://api.whatnot.com/seller-api/rest/oauth/authorize`
  - Token URL: `https://api.whatnot.com/seller-api/rest/oauth/token`

Ship order items under a tracking code from the seller's own label. The items move onto one shipment with the tracking code, usually a new one, so read each item's shipment afterwards. The items must ship to the same buyer and address, their shipments must not have been dropped off or shipped, and the seller must be able to use their own labels. Requires write:shipments.

## Request body

- AddTrackingCodeRequest
  - `order_item_ids` string[], required: The decimal IDs of the order items to ship under the tracking code.
  - `tracking_code` string, required: The carrier's tracking code for the package.
  - `carrier` string, required: The carrier delivering the package.

## Response `204`

Successful Response

## Other responses

- `409`: The order items can't take this tracking code.
- `422`: Invalid request, unknown order items, or an invalid tracking code.
- `503`: Seller-provided tracking codes are unavailable.

---

[API](https://skmtc.dev/whatnot/apis/whatnot-seller-api.md) - [All operations](https://skmtc.dev/whatnot/apis/whatnot-seller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whatnot/apis/whatnot-seller-api/revisions/e619f15f7ce0?raw)