---
title: "Create Cart Order Shipment"
method: POST
path: "/cart/orders/{order_id}/shipments"
tags: ["cart", "Orders"]
---

# Create Cart Order Shipment

`POST /cart/orders/{order_id}/shipments`

Get the required, optional, and integration specific fields by calling the [integrations](/api-reference/mgmt/integrations) endpoint.

## Path parameters

- `order_id` string, required

## Headers

- `x-trackstar-api-key` string, required
- `x-trackstar-access-token` string, required

## Request body

- union
  - object
    - `tracking_number` string, required — The tracking number for the shipment.
    - `tracking_url` string, required — The URL for the tracking number.
    - `carrier_name` string, required — The name of the carrier used to ship the order.
    - `shipping_method_name` string, required — The name of the actual shipping method.
  - object
    - `tracking_number` string, required — The tracking number for the shipment.
    - `carrier_name` '17FEIA' | '360lion' | '4PX' | 'A-1' | 'AAA Cooper' | 'ABF' | 'AFL/Fedex' | 'Airtel' | 'ALLJOY' | 'AMAUK' | 'AMAZON HORIZON' | 'Amazon Shipping' | 'AMZL' | 'AMZL_UK' | 'Andere' | 'Anjun' | 'AO' | 'AO Deutschland' | 'APC' | 'APC Overnight' | 'APC POSTAL LOGISTICS' | 'APG eCommerce' | 'Aramex' | 'ARAS' | 'Aras Kargo' | 'Arco Spedizioni' | 'Arkas' | 'Arrow XL' | 'Asendia' | 'Asgard' | 'Assett' | 'AT POST' | 'ATPOST' | 'ATS' | 'AUSSIE_POST' | 'Australia Post' | 'Australia Post-ArticleID' | 'Australia Post-Consignment' | 'B2C' | 'B2C Europe' | 'B2CShip' | 'Balnak' | 'Bartolini' | 'Beijing Quanfeng Express' | 'Best Buy' | 'Best Express' | 'Better Trucks' | 'BJS' | 'Blowhorn' | 'Blue Package' | 'BlueDart' | 'BoÄŸaziçi' | 'Bombax' | 'Bombino Express' | 'BPOST' | 'BR1 Express' | 'BRT' | 'Buylogic' | 'Cainiao' | 'Canada Post' | 'Canpar' | 'CargoLine' | 'Caribou' | 'Cart2India' | 'CBHub' | 'CBL' | 'CDC' | 'CELERITAS' | 'Centex' | 'CEVA' | 'Ceva Lojistik' | 'China Post' | 'Chrono Express' | 'Chronopost' | 'Chukou1' | 'Cititrans' | 'City Link' | 'CityPost' | 'CNE' | 'Coliposte' | 'Colis Privé' | 'Colissimo' | 'Consegna Mezzi Propri' | 'Conway' | 'Correios' | 'Correos' | 'Correos Express' | 'COSCO' | 'CouriersPlease' | 'CTT EXPRESS' | 'Cubyn' | 'CyberSavings' | 'DACHSER' | 'DAIPOST' | 'DB Schenker' | 'DEL Deliveries' | 'Delhivery' | 'Delivengo' | 'Delivery Group' | 'Der Kurier' | 'DESERTCART' | 'Deutsche Post' | 'DFL' | 'DHL' | 'DHL eCommerce' | 'DHL Express' | 'DHL Freight' | 'DHL Global Mail' | 'DHL Home Delivery' | 'DHL Kargo' | 'DHL-Paket' | 'DHL Parcel UK' | 'DHLPL' | 'Digital Delivery' | 'DirectLog' | 'Dotzot' | 'DPB' | 'DPD' | 'DPD Local' | 'DSV' | 'DTDC' | 'DX' | 'DX Express' | 'DX Freight' | 'DX Secure' | 'DYNAMIC EXPRESS' | 'ECMS' | 'ECMS express' | 'Ecom Express' | 'Ecom Shipping solutions PVT ltd' | 'EINSA SOURCING' | 'EKI Trans' | 'Emirates Post' | 'Emons' | 'Endopack' | 'Energo' | 'Envialia' | 'ePost Global' | 'Equick' | 'ESNAD' | 'Estafeta' | 'Estes' | 'EUB' | 'Europaczka' | 'Exapaq' | 'FAST EST' | 'Fastway' | 'FedEx' | 'Fedex Freight' | 'FEDEX JP' | 'FedEx SmartPost' | 'FERCAM' | 'Fillo Kargo' | 'First Flight' | 'First Flight China' | 'First Mile' | 'Fleetan' | 'Flyt' | 'FRACHTPOST' | 'FRANCE EXPRESS' | 'Gati' | 'GEL' | 'GEL Express' | 'geodis' | 'Geodis Calberson' | 'Geopost Kargo' | 'GFS' | 'GLS' | 'GLS Canada' | 'GO!' | 'Gojavas' | 'GRUPO LOGISTIC' | 'Hellmann' | 'Heppner' | 'Hermes' | 'Hermes (Corporate)' | 'Hermes Einrichtungsservice' | 'Hermes Logistik Gruppe' | 'Hermes UK' | 'Hlog' | 'HNC' | 'Home Logistics' | 'honesteye' | 'Hongkong Post' | 'Horoz Lojistik' | 'Hotpoint Logistics' | 'HRP' | 'HS code' | 'HUAHAN Logistics' | 'HubEurope' | 'Hunter Express' | 'Hunter Logistics' | 'Huxloe' | 'Huxloe Logistics' | 'ICC Worldwide' | 'IDS' | 'IDS Netzwerk' | 'iMile' | 'India Post' | 'InPost' | 'Interlink' | 'Interno' | 'Intersoft' | 'iParcel' | 'ITD Global' | 'J&T Express' | 'Japan Post' | 'JCEX' | 'Jersey Post' | 'Jiufang' | 'JP EXPRESS' | 'JPL UPU' | 'JS Express' | 'JT' | 'JT Express' | 'JY Express' | 'Kargokar' | 'KEAVO' | 'Kerry' | 'Kuehne+Nagel' | 'Kybotech' | 'La Poste' | 'Landmark' | 'Landmark Global' | 'Lasership' | 'Lemonmode' | 'Letian' | 'LF Logistic' | 'Liccardi' | 'Liccardi Trasporti' | 'Logistik Gruppe' | 'Loomis' | 'Mail Alliance' | 'Mail Americas' | 'Mainpost' | 'MBE' | 'Metro Kargo' | 'Mezzi propri' | 'MHI' | 'Milkman' | 'MNG Kargo' | 'Mondial Relay' | 'MRW' | 'MZZ-Briefdienst' | 'Nacex' | 'NAQEL EXPRESS' | 'Narpost Kargo' | 'New Zealand Post' | 'Newgistics' | 'Nexive' | 'Ninjavan' | 'NipponExpress' | 'NITTSU' | 'NOVEO' | 'NowBikes' | 'NTL' | 'OCS Worldwide' | 'Old Dominion' | 'OneWorldExpress' | 'ONTIME' | 'OnTrac' | 'OSM' | 'OSM Worldwide' | 'Other' | 'Otro' | 'Overnite Express' | 'Palletline' | 'Palletways' | 'Panther' | 'Parcel Hub' | 'Parcel Monkey' | 'Parcel Station' | 'Parcel2go' | 'ParcelDenOnline' | 'Parcelforce' | 'Parcelhub' | 'Parcelink Logistics' | 'Parcelnet' | 'ParcelOne' | 'Paquetexpress' | 'PDC Logistics' | 'Pidge' | 'Pilot' | 'Pilot Freight' | 'PIN' | 'Polish Post' | 'Pos Laju' | 'Post Modern' | 'Poste Italiane' | 'PostNL' | 'PostNord' | 'Professional' | 'PTT Kargo' | 'PUROLATOR' | 'Quantium' | 'Qxpress' | 'R+L' | 'Raben Group' | 'RBNA' | 'REDUR' | 'Redpack' | 'Rhenus' | 'Rieck' | 'Rivigo' | 'RMLGB' | 'ROADIE' | 'Roadrunner' | 'Royal Mail' | 'RR Donnelley' | 'Safexpress' | 'SAGAWA' | 'SAGAWA EXPRESS' | 'Saia' | 'Sailpost' | 'Schweizer Post' | 'SDA' | 'Seino' | 'SEINO TRANSPORTATION' | 'Seko Logistics' | 'Selem Kargo' | 'Self Delivery' | 'Sendcloud' | 'Sending' | 'SENDLE' | 'Seur' | 'Seven Senders' | 'SF Express' | 'SFC' | 'Ship Delight' | 'Ship Global US' | 'SHIPA' | 'ShipEconomy' | 'ShipEntegra' | 'ShipGlobal' | 'Shipmate' | 'Shippit' | 'Shopini World' | 'Shree Maruti Courier' | 'Shree Tirupati Courier' | 'Shunfeng Express' | 'Sinerlog' | 'Singapore Post' | 'Sinotrans' | 'Skypostal' | 'Smartmail' | 'Smartrlogistics' | 'SMSA' | 'SMSA Express' | 'Soarmall' | 'Sonstige' | 'South Eastern Freight Lines' | 'Speedaf' | 'Speedex' | 'Spoton' | 'SPRING' | 'spring GDS' | 'Sprint' | 'Stahlmann and Sachs' | 'Stampit' | 'Staples' | 'StarTrack-ArticleID' | 'StarTrack-Consignment' | 'STG' | 'STO Express' | 'Streamlite' | 'Sunyou' | 'Sürat Kargo' | 'Susa' | 'Swiss post' | 'Szendex' | 'Target' | 'TATA Express' | 'TDN' | 'Team Express' | 'Tezel Lojistik' | 'The Delivery Group' | 'The Professional Couriers' | 'TIPSA' | 'TNT' | 'TNT Kargo' | 'TNTIT' | 'Toll' | 'Toll Global Express' | 'Tongda Global' | 'Topyou' | 'Total Express' | 'Tourline' | 'Trackon' | 'Trakpak' | 'Transaher' | 'Transaragonés' | 'TransFolha' | 'Translink' | 'Trans-o-Flex' | 'Truline' | 'TSB' | 'Tuffnells' | 'TWS' | 'TXT' | 'TyD' | 'UBI' | 'UKMail' | 'UniUni' | 'UPakWeShip' | 'UPS' | 'UPS Freight' | 'UPS Mail Innovations' | 'Upsilon' | 'UPSMI' | 'Urban Express' | 'Uship' | 'USPS' | 'Verage Shipping' | 'Via Xpress' | 'VIR' | 'VNLIN' | 'WanbExpress' | 'Watkins and Shepard' | 'Wefast' | 'WeWorldExpress' | 'Whistl' | 'Whizzard' | 'WINIT' | 'WPX' | 'XDP' | 'XPO' | 'XPO Freight' | 'Xpressbees' | 'YAMATO' | 'YAMATO TRANSPORT' | 'YANWEN' | 'YDH' | 'Yellow Freight' | 'YF Logistics' | 'YFHEX' | 'YHT' | 'Yodel' | 'YTO Express' | 'Yun Express' | 'Yunda Express' | 'Yurtiçi Kargo' | 'ZAD Express' | 'Zeleris' | 'Zippee' | 'ZTO Express' | 'Zust Ambrosetti', required — The name of the carrier used to ship the order.
    - `shipping_method_name` string — The name of the actual shipping method.
    - `requested_shipping_method` string — The type of shipping method requested by the customer.
    - `shipped_date` string, date-time, required — When the order was shipped
    - `skip_retrieval` boolean — Skip resource retrieval after successful create operation
    - `package_reference_id` string — Reuse the packageReferenceId from a prior shipment on this order to edit it instead of creating a new package (e.g. to replace tracking after a voided label).
    - `line_items` CartOrderWriteLineItemamazon[] — List of the products included in the order.
      - `product_sku` string
      - `sku` string — Use product_sku instead.
      - `quantity` integer — Quantity to ship
      - `transparency_codes` string[] — Amazon Transparency codes for serialized items
  - object
    - `carrier_id` 'auspost' | 'canadapost' | 'endicia' | 'usps' | 'fedex' | 'ups' | 'upsready' | 'upsonline' | 'shipperhq' | 'royalmail', required — The ID of the carrier
    - `tracking_number` string, required — The tracking number for the shipment.
  - object
    - `line_items` CartOrderCreateLineItemebay[], required — List of the products included in the order.
      - `product_sku` string, required
      - `line_item_id` string
      - `quantity` integer
    - `shipped_date` string, date-time — When the order was shipped. If not provided, will default to current date.
    - `carrier_name` 'UPS' | 'USPS' | 'FedEx' | 'FourPX' | 'FourPXCHINA' | 'FourPXLTD' | 'SevenLSP' | 'A1CourierServices' | 'ABF' | 'AMWST' | 'ARAMEX' | 'ARVATO' | 'AustraliaPost' | 'AVRT' | 'BELGIANPOST' | 'BKNS' | 'BluePackage' | 'CanPar' | 'CENF' | 'CEVA' | 'ChinaPost' | 'Chronopost' | 'CHUKOU1' | 'ChunghwaPost' | 'CitiPost' | 'CNWY' | 'ColiposteDomestic' | 'ColiposteInternational' | 'Correos' | 'CPC' | 'DayandRoss' | 'DBSchenker' | 'DeutschePost' | 'DHL' | 'DHLGlobalMail' | 'DHLEKB' | 'DHLG' | 'DPXThailand' | 'EMF' | 'FedExSmartPost' | 'FLYT' | 'FlytExpressUSDirectline' | 'FTFT' | 'FulfilExpressAccStation' | 'FulfilExpresseForCity' | 'FulfilExpressEverydaySource' | 'FulfilExpressiTrimming' | 'HDUSA' | 'Hermes' | 'HomeDeliveryNetwork' | 'HongKongPost' | 'iLoxx' | 'IndiaPost' | 'IndonesiaPost' | 'InterPost' | 'Iparcel' | 'IsraelPost' | 'JapanPost' | 'KIALA' | 'KoreaPost' | 'LAPOSTE' | 'Landmark' | 'LDSO' | 'LTL' | 'MALAYSIAPOST' | 'MannaFreight' | 'MNGTurkey' | 'MSI' | 'Nacex' | 'NEMF' | 'ODFL' | 'OFFD' | 'ONTRACK' | 'Other' | 'OVNT' | 'ParcelPool' | 'Parcelforce' | 'Philpost' | 'Pilot' | 'PITD' | 'POSTITALIANO' | 'Prestige' | 'Quantium' | 'RETL' | 'RoyalMail' | 'RRUN' | 'SAIA' | 'Seur' | 'SFC' | 'SINGAPOREPOST' | 'SioliandFontana' | 'SkynetMalaysia' | 'SpeeDee' | 'SuntekExpressLTD' | 'SwissPost' | 'TELE' | 'THAILANDPOST' | 'TNT' | 'TPG' | 'TWW' | 'UBI' | 'UPSMailInnovations' | 'UPSC' | 'USFG' | 'USPSCeP' | 'USPSPMI' | 'VietnamPost' | 'VITR' | 'WATKINS' | 'Winit' | 'Wise' | 'WNdirect' | 'WPX' | 'YANWEN' | 'YRC' | 'FLYTExpress' | 'SFCExpress' | 'FourPXExpress' | 'FASTWAYCOURIERS' | 'ALLIEDEXPRESS' | 'HUNTEREXPRESS' — The name of the carrier used to ship the order.
    - `tracking_number` string — The tracking number for the shipment.
  - object
    - `carrier_name` 'CANADA_POST' | 'DHL_ECOMMERCE' | 'DHL_EXPRESS' | 'FEDEX' | 'PUROLATOR' | 'UPS' | 'USPS' | 'POSTNL' | 'CANPAR' | 'INTERLINK_EXPRESS' | 'GSO' | 'ROYAL_MAIL' | 'DPD' | 'DPDUK' | 'PARCELFORCE' | 'AUSTRALIA_POST' | 'EVRI' | 'LA_POSTE', required — The name of the carrier used to ship the order.
    - `tracking_number` string, required — The tracking number for the shipment.
    - `shipping_cost` number, required — Cost for this shipment
  - object
    - `carrier_name` string, required — The name of the carrier used to ship the order.
    - `tracking_number` string, required — The tracking number for the shipment.
  - object
    - `tracking_number` string — The tracking number for the shipment.
    - `carrier_id` 'fedex' | 'ups' | 'usps' | 'dhl' — The carrier code. Required if tracking_number is provided.
    - `line_items` CartOrderCreateLineItemmagento[] — List of the products included in the order.
      - `product_sku` string
      - `sku` string — Use product_sku instead.
      - `quantity` integer, required
  - object
    - `tracking_number` string — The tracking number for the shipment.
    - `tracking_url` string — The URL for the tracking number.
    - `carrier_name` string, required — The name of the carrier used to ship the order.
    - `line_items` CartOrderWriteLineItemmirakl[], required — List of the products included in the order.
      - `line_item_id` string, required — The ID of the line item in the order
      - `quantity` integer, required
  - object
    - `tracking_number` string, required — The tracking number for the shipment.
    - `line_items` CartOrderCreateLineItemnuorder[], required — List of the products included in the order.
      - `product_sku` string, required
      - `quantity` integer, required
    - `carrier_name` string, required — The name of the carrier used to ship the order.
  - object
    - `tracking_number` string, required — The tracking number for the shipment.
    - `carrier_name` string, required — The name of the carrier used to ship the order.
    - `shipping_method_name` string, required — The name of the actual shipping method.
    - `warehouse_id` string, required — The warehouse the shipment was shipped from. Can be passed into the [Warehouse](/api-reference/cart-api/warehouses/get-item) endpoint for more details.
    - `ship_date` string, date-time, required — The date the order was shipped.
  - object
    - `tracking_number` string, required — The tracking number for the shipment.
    - `tracking_url` string, required — The URL for the tracking number.
    - `carrier_name` string, required — The name of the carrier used to ship the order.
    - `shipping_method_name` string, required — The name of the actual shipping method.
  - object
    - `tracking_number` string, required — The tracking number for the shipment.
    - `tracking_url` string, required — The URL for the tracking number.
    - `notify_customer` boolean — Whether the customer should be notified via email.
    - `shipping_groups` ShopifyCartOrderShippingGroup[], required — Sets of line items that will be fulfilled together from the same locations.
      - `shipping_group_id` string, required — The ID of the shipping_group.
      - `line_items` ShopifyCartOrderShipmentLineItem[] — List of the products in the shipping group. Defaults to all if not specified.
        - `line_item_id` string, required — The ID of the line item in the shipping group.
        - `quantity` integer, required
  - object
    - `tracking_number` string, required — The tracking number for the shipment.
    - `tracking_url` string — The URL for the tracking number.
    - `carrier_name` string, required — The name of the carrier used to ship the order.
    - `shipping_method_name` string, required — The name of the actual shipping method.
    - `ship_date` string, date-time, required — The date the shipment was shipped.
  - object
    - `tracking_number` string, required — The tracking number for the shipment.
    - `shop_id` string, required — The TikTok shop ID of the product to create this shipment for. If you only have one shop, we will default to it.
    - `carrier_name` string — The name of the carrier used to ship the order to the customer.
    - `carrier` string — The name of the carrier used to ship the order to the customer. Use carrier_name instead.
    - `line_items` CartOrderWriteLineItemtiktok[] — List of the products included in the order.
      - `line_item_id` string, required — The ID of the order line item to ship.
      - `quantity` 1 — The quantity to ship. TikTok tracks each unit of a product as its own order line item, so this must be 1. To ship multiple units, pass each unit's line item ID.
    - `skip_retrieval` boolean — Skip resource retrieval after successful create operation
  - object
    - `line_items` CartOrderWriteLineItemwalmart[], required — List of the products included in the order.
      - `product_sku` string
      - `sku` string — Use product_sku instead.
      - `quantity` integer, required
    - `carrier_name` 'UPS' | 'USPS' | 'FedEx' | 'Airborne' | 'OnTrac' | 'DHL Ecommerce - US' | 'DHL' | 'LS' | 'UDS' | 'UPSMI' | 'FDX' | 'PILOT' | 'ESTES' | 'SAIA' | 'FDS Express' | 'Seko Worldwide' | 'HIT Delivery' | 'FEDEXSP' | 'RL Carriers' | 'Metropolitan Warehouse & Delivery' | 'China Post' | 'YunExpress' | 'Yellow Freight Sys' | 'AIT Worldwide Logistics' | 'Chukou1' | 'Sendle' | 'Landmark Global' | 'Sunyou' | 'Yanwen' | '4PX' | 'GLS' | 'OSM Worldwide' | 'FIRST MILE' | 'AM Trucking' | 'CEVA' | 'India Post' | 'SF Express' | 'CNE' | 'TForce Freight' | 'AxleHire' | 'LSO' | 'Royal Mail' | 'ABF Freight System' | 'WanB' | 'Roadrunner Freight' | 'Meyer Distribution' | 'AAA Cooper' | 'Canada Post' | 'Southeastern Freight Lines' | 'Japan Post' | 'Correos de Mexico' | 'XPO Logistics' | 'JD Logistics' | 'YDH' | 'JCEX' | 'Flyt' | 'Deutsche Post' | 'Better Trucks' | 'Asendia' | 'SFC' | 'UBI' | 'ePost Global' | 'YF Logistics' | 'RXO' | 'Estes Express' | 'Shypmax' | 'WIN.IT America' | 'PITT OHIO' | 'PostNord Sweden' | 'Equick' | 'Whistl' | 'Tusou' | 'Shiprocket' | 'DTDC' | 'PTS', required — The name of the carrier used to ship the order.
    - `requested_shipping_method` 'Standard' | 'Express' | 'OneDay' | 'Freight' | 'WhiteGlove' | 'Value', required — The type of shipping method requested by the customer.
    - `tracking_number` string, required — The tracking number for the shipment.
    - `skip_retrieval` boolean — Skip resource retrieval after successful create operation
  - object
    - `shipping_method_name` '2nd Day Air Delivery' | '2-Day Delivery -- Free!' | 'Global 5-Day Direct Delivery' | '3 Day Delivery' | 'Container' | 'Zustellung per Email' | 'FedEx Home Delivery' | 'Small Parcel Courier' | 'Ground - Delivery Signature Required' | 'Small Parcel Courier' | 'Imperial Pool Freight' | 'Next Day Air' | 'Next Day Air (AK,HI,PR)' | 'UK - SP - Next day before noon' | 'UK - SP - Next day before 9am' | 'Will Call' | 'UK - SP - Saturday delivery' | 'Casket Delivery - 1 Day' | 'Casket Delivery - 2 Day' | 'Curbside with unload service' | 'Truck Load' | 'Curbside without unload service' | 'Spedition - frei Bordsteinkante' | 'Room of Choice & Packaging Removal' | 'Premium 2-Man Delivery' | 'Room of Choice Delivery with Installation' | 'Room of Choice' | 'Truck Freight - Threshold' | 'Standard-Versand Sperrgut' | 'ALMO - Room of Choice + Removal of Old Appliance' | 'Large Parcel Courier' | 'European Line Haul' | 'Economy' | 'White Glove Delivery - Room of Choice' | 'Small Parcel' | 'GROUND (AK,HI,PR)' | 'Low Cost Carrier' | 'Backyard Drop-Off' | 'Curbside Delivery' | 'Inside Delivery - Packaging Removal & Removal of Old Appliance' | 'One Man Premium' | 'Inside Delivery - Packaging Removal' | 'Threshold Delivery' | 'Large Parcel Courier' | 'Allied Road Express' | 'Hunter Road Express' | 'White Glove - Capital Cities' | 'Spedition - frei Bordsteinkante' | 'Large Parcel Courier' | 'In Home Mattress Set Up & Removal' | 'Room of Choice Delivery w/ Installation' | 'Room of Choice Delivery w/ Installation & Haul Away' | 'Room of Choice Delivery w/ Haul Away' | 'Room of Choice Delivery w/ Move to Another Room' | 'Room of Choice Delivery w/ Install & Move to Another Room' | 'Room of Choice Delivery' | 'Samsung Delivery Service' | 'Wayfair Large Appliances Delivery' | 'Off The Shelf Item' | 'Backyard Drop Off' | 'Big and Bulky Outdoor Drop Off' | 'Big and Bulky Backyard Delivery' | 'Big and Bulky Threshold' | 'Big and Bulky Room of Choice' | 'Big and Bulky WG' | 'Fulfilled by Amazon', required — The name of the actual shipping method.
    - `carrier_name` string, required — The name of the carrier used to ship the order.
    - `tracking_number` string, required — The tracking number for the shipment.
    - `ship_date` string, date-time — The date the shipment was shipped.
    - `ship_from_address` ShipFromAddressWayfair, required
      - `full_name` string, required
      - `address1` string, required
      - `address2` string
      - `city` string, required
      - `state` string
      - `postal_code` string
      - `country` string, required
  - object
    - `tracking_number` string, required — The tracking number for the shipment.
    - `tracking_url` string — The URL for the tracking number.
    - `carrier_name` string, required — The name of the carrier used to ship the order.
    - `line_items` CartOrderWriteLineItemwix[], required — List of the products included in the order.
      - `line_item_id` string, required — The ID of the order line item.
      - `quantity` integer — Quantity to fulfill.
  - object
    - `tracking_number` string — The tracking number for the shipment.
    - `carrier_name` 'An Post' | 'Australia Post' | 'BRT (Bartolini)' | 'Bring.se' | 'Canada Post' | 'Colissimo' | 'Correios' | 'Courier Post' | 'DB Schenker' | 'DHL' | 'DHL Express' | 'DHL Intraship (DE)' | 'DHL.cz' | 'DHL.se' | 'DPD.NL' | 'DPD.at' | 'DPD.co.uk' | 'DPD.cz' | 'DPD.de' | 'DPD.ie' | 'DTDC' | 'Deutsche Post DHL' | 'Fastway Couriers' | 'Fastways' | 'FedEx Sameday' | 'Fedex' | 'Hermes' | 'InterLink' | 'Itella' | 'NZ Post' | 'OnTrac' | 'PBT Couriers' | 'PPL.cz' | 'ParcelForce' | 'PostNL' | 'Posten AB' | 'Royal Mail' | 'SAPO' | 'TNT Express (consignment)' | 'TNT Express (reference)' | 'UK Mail' | 'UPS' | 'UPS Germany' | 'UPS.se' | 'USPS' | 'dhl.at' | 'post.at' | 'Česká pošta' — The name of the carrier used to ship the order.
    - `tracking_url` string — The URL for the tracking number.
    - `mark_order_as_shipped` boolean — The order will be marked as shipped after the shipment is created. Defaults to true.

## Response `200`

Successful response

- CartCreateShipmentOrderResponse
  - `data` CreateCartOrderShipmentResponseDataSchema
    - `id` string, required — The unique ID of the order.
    - `order_number` string, required — The order number assigned by the platform. Defaults to order ID.
    - `created_date` string, date-time, required — The date the order was created.
    - `updated_date` string, date-time, required — The date the order was last updated.
    - `status` 'open' | 'confirmed' | 'processing' | 'partially_fulfilled' | 'fulfilled' | 'exception' | 'cancelled' | 'backordered' | 'other', required — The status of the order. See the [order information](info) for more details.
    - `raw_status` string, nullable, required — The raw status (if available) returned directly from the platform.
    - `requested_shipping_method` string, nullable, required — The type of shipping method requested by the customer.
    - `shipping_method_id` string, nullable, required — The ID of the actual shipping method.
    - `shipping_method_name` string, nullable, required — The name of the actual shipping method.
    - `carrier_id` string, nullable, required — The ID of the carrier used to ship the order.
    - `carrier_name` string, nullable, required — The name of the carrier used to ship the order.
    - `invoice_currency_code` string, required — The currency used for this order. If not provided explicitly, defaults to USD.
    - `total_price` number, nullable, required — The total price a customer paid for the order.
    - `total_tax` number, nullable, required — The total tax on the order.
    - `total_discount` number, nullable, required — The total amount discounted from the order.
    - `total_shipping` number, nullable, required — The total shipping cost for the order incurred by the customer.
    - `ship_to_address` ShipToAddress, required
      - `full_name` string, nullable, required
      - `company` string, nullable, required
      - `address1` string, nullable, required
      - `address2` string, nullable, required
      - `address3` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `postal_code` string, nullable, required
      - `country` string, nullable, required
      - `phone_number` string, nullable, required
      - `email_address` string, nullable, required
    - `bill_to_address` BillToAddress, required
      - `full_name` string, nullable, required
      - `address1` string, nullable, required
      - `address2` string, nullable, required
      - `address3` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `postal_code` string, nullable, required
      - `country` string, nullable, required
    - `earliest_ship_date` string, date-time, nullable, required — The earliest date the order can be shipped.
    - `latest_ship_date` string, date-time, nullable, required — The latest date the order can be shipped.
    - `line_items` CartOrderLineItem[], required — List of the products included in the order.
      - `line_item_id` string, required — The ID of the line item.
      - `product_id` string, required — The ID of the product. Can be passed into the [Cart Product](/api-reference/cart-api/products/get-item) endpoint for more details.
      - `product_sku` string, nullable, required
      - `parent_product_id` string, nullable, required — The ID of the product's parent.
      - `parent_product_sku` string, nullable, required
      - `quantity` integer, required
      - `unit_price` number, nullable, required — The price of the product in the currency specified by `invoice_currency_code`.
      - `discount` number, nullable, required — The unit amount discounted from the product for this order. This is the amount of discount per unit of the product.
      - `tax` number, nullable, required — The unit amount of tax on the product for this order. This is the amount of tax per unit of the product
      - `warehouse_id` string, nullable, required — The warehouse this line item should ship from. Can be passed into the [Warehouse](/api-reference/cart-api/warehouses/get-item) endpoint for more details.
    - `shipping_groups` CartOrderShippingGroup[], required — Sets of line items that will be fulfilled together from the same locations. Only applies in Shopify, as fulfillmentOrders.
      - `shipping_group_id` string, required — The ID of the shipping_group.
      - `created_date` string, date-time, required — The date the shipping_group was created.
      - `updated_date` string, date-time, required — The date the shipping_group was last updated.
      - `raw_status` string, nullable, required — The raw status (if available) of the shipping group returned directly from the integration.
      - `status` 'open' | 'shipped' | 'delivered' | 'cancelled' | 'exception' | 'on_hold' | 'other', nullable, required — The status of the shipping group.
      - `warehouse_id` string, required — The ID of the warehouse that the shipping group will send from. Subject to change.
      - `line_items` CartOrderShipmentGroupLineItem[], required — List of the products in the shipping group.
        - `line_item_id` string, required — The ID of the line item in the shipping group.
        - `product_id` string, required — The ID of the product.
        - `product_sku` string, nullable, required
        - `parent_product_id` string, nullable, required — The ID of the product's parent.
        - `quantity` integer, required
    - `shipments` CartOrderShipment[], required — List of the shipments sent out to the customer.
      - `shipment_id` string, required — The ID of the shipment.
      - `raw_status` string, nullable, required — The raw status (if available) of the shipment returned directly from the integration.
      - `status` 'open' | 'shipped' | 'delivered' | 'cancelled' | 'exception' | 'on_hold' | 'other', nullable, required — The status of the shipment.
      - `warehouse_id` string, nullable, required — The warehouse the shipment was shipped from. Can be passed into the [Warehouse](/api-reference/cart-api/warehouses/get-item) endpoint for more details.
      - `shipping_method_id` string, nullable, required — The ID of the shipping method used for the shipment.
      - `shipping_method_name` string, nullable, required — The name of the shipping method used for the shipment.
      - `carrier_id` string, nullable, required — The ID of the carrier used to ship the shipment.
      - `carrier_name` string, nullable, required — The name of the carrier used to ship the shipment.
      - `tracking_number` string, nullable, required — The tracking number for the shipment.
      - `tracking_url` string, nullable, required — The URL for the tracking number.
      - `line_items` CartOrderShipmentLineItem[], required — List of the products listed in the shipment.
        - `shipment_line_item_id` string, required — The ID of the line item in the shipment.
        - `product_id` string, required — The ID of the product.
        - `product_sku` string, nullable, required
        - `parent_product_id` string, nullable, required — The ID of the product's parent.
        - `parent_product_sku` string, nullable, required
        - `quantity` integer, required
      - `shipping_groups` string[], required — List of the shipping groups included in the shipment. Only applies in Shopify, as fulfillmentOrders.
      - `ship_from_address` ShipFromAddress, required
        - `address1` string, nullable, required
        - `address2` string, nullable, required
        - `address3` string, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required
        - `postal_code` string, nullable, required
        - `country` string, nullable, required
      - `created_date` string, date-time, nullable, required — The date the shipment was created.
      - `updated_date` string, date-time, nullable, required — The date the shipment was last updated.
    - `tags` string[], required — A list of tags associated with the order.
    - `external_system_url` string, nullable, required — URL link to the order in the external system (WMS/Freight etc).
    - `trackstar_tags` unknown[], nullable, required — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `additional_fields` object, required — Integration-specific fields
    - `trackstar_created_date` string, date-time, required
    - `trackstar_updated_date` string, date-time, required
  - `id` string, required — The ID of the object that has been created or modified
  - `unused_fields` string[], required — Unused fields

## Other responses

- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.net/trackstarhq/apis/trackstar-api.md) · [All operations](https://skmtc.net/trackstarhq/apis/trackstar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trackstarhq/trackstar-api/versions/4bc5c6e1a8bf/schema)