The Create label API lets you buy labels from Walmart to ship orders.

Endpoint

POST https://marketplace.walmartapis.com/v3/shipping/labels

Function

Use this API to:

Create domestic shipment labels with optional add-on features such as:
- Shipment protection: When Shipment Protection is enabled, Walmart will provide a replacement or refund if a shipment is lost, damaged, or stolen during transit.
- Signature protection: Requires the recipient to sign to confirm they received the order upon delivery. This feature provides an added layer of security and proof of delivery.
Create international order shipment labels.
Get tracking numbers, carrier services, or tracking URLs in the response.
(US marketplace only) Create a label with your carrier account. A seller must onboard through the Walmart Seller Center UI to use their own account when buying a shipping label from a partner.

Request Sample

Sample Request 1

curl --request POST \ --url https://marketplace.walmartapis.com/v3/shipping/labels \ --header 'Accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "packageType": "CUSTOM_PACKAGE", "boxDimensions": { "boxDimensionUnit": "IN", "boxWeightUnit": "LB", "boxWeight": 13, "boxLength": 13, "boxWidth": 9, "boxHeight": 0 }, "boxItems": [ { "lineNumber": "1", "sku": "PRECISE3PGLASS9", "quantity": 1 } ], "fromAddress": { "contactName": "Test Seller", "companyName": "Test Company", "addressLine1": "Add1", "addressLine2": "Add2", "city": "Anchorage", "state": "AK", "postalCode": "99501", "country": "US", "phone": "12253", "email": "[email protected]" }, "purchaseOrderId": "97108719025934786", "carrierName": "FedEx", "carrierServiceType": "FEDEX_2_DAY", "hazmat": true
}
'

Sample Request 2

curl --request POST \ --url https://marketplace.walmartapis.com/v3/shipping/labels \ --header 'Accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "packageType": "CUSTOM_PACKAGE", "boxDimensions": { "boxDimensionUnit": "IN", "boxWeightUnit": "LB", "boxWeight": 13, "boxLength": 13, "boxWidth": 9, "boxHeight": 0 }, "boxItems": [ { "lineNumber": "1", "sku": "PRECISE3PGLASS9", "quantity": 1 } ], "fromAddress": { "contactName": "Test Seller", "companyName": "Test Company", "addressLine1": "Add1", "addressLine2": "Add2", "city": "Anchorage", "state": "AK", "postalCode": "99501", "country": "US", "phone": "12253", "email": "[email protected]" }, "addOns": [ "INSURANCE", "SIGNATURE" ], "purchaseOrderId": "97108719025934786", "carrierName": "FedEx", "carrierServiceType": "FEDEX_2_DAY"
}
'

Sample Request 3

curl --request POST \ --url https://marketplace.walmartapis.com/v3/shipping/labels \ --header 'Accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "packageType": "CUSTOM_PACKAGE", "boxDimensions": { "boxDimensionUnit": "IN", "boxWeightUnit": "LB", "boxWeight": 13, "boxLength": 13, "boxWidth": 9, "boxHeight": 0 }, "boxItems": [ { "lineNumber": "1", "sku": "PRECISE3PGLASS9", "quantity": 1, "productName": "racket", "productNameInLocale": "读写汉字" } ], "fromAddress": { "contactName": "Test Seller", "companyName": "Test Company", "addressLine1": "Add1", "addressLine2": "Add2", "city": "guangZhouShi", "state": "GD", "postalCode": "510599", "country": "CN", "phone": "12253", "email": "[email protected]" }, "returnAddress": { "contactName": "深圳市市盛天育科区游乡寺 - 10001223622 - MP", "addressLine1": "福田区石峡新田世纪商务中心B座36楼11室", "city": "深圳", "state": "系列", "postalCode": "581000", "country": "CN", "phone": "9087654589", "email": "[email protected]", "shipNode": "765476571" }, "purchaseOrderId": "97108719025934786", "carrierName": "Yanwen", "carrierServiceType": "YANWEN_EXPRESS", "hasBattery": true
}
'

Sample Request 4

curl --request POST \ --url https://marketplace.walmartapis.com/v3/shipping/labels \ --header 'Accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "packageType": "CUSTOM_PACKAGE", "boxDimensions": { "boxDimensionUnit": "IN", "boxWeightUnit": "LB", "boxWeight": 2, "boxLength": 2, "boxWidth": 2, "boxHeight": 2 }, "boxItems": [ { "sku": "SKUWfs6055469496189", "quantity": 1, "lineNumber": "1" } ], "fromAddress": { "contactName": "Shoes.com - 10900015173 - MP", "addressLine1": "2050 Royal Dr, Apt-7", "addressLine2": "Apt-7", "city": "SANTA CLARA", "state": "CA", "postalCode": "95050", "country": "US", "phone": "8024455150" }, "purchaseOrderId": "108919840486078", "carrierName": "FedEx", "carrierServiceType": "FEDEX_EXPRESS_SAVER", "accountType": "OWN", "shipOnDate": "2026-06-02"
}
'

Sample Request 5

curl --request POST \ --url https://marketplace.walmartapis.com/v3/shipping/labels \ --header 'Accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "packageType": "CUSTOM_PACKAGE", "boxDimensions": { "boxDimensionUnit": "IN", "boxWeightUnit": "KG", "boxWeight": 13, "boxLength": 13, "boxWidth": 9, "boxHeight": 0 }, "boxItems": [ { "lineNumber": "1", "sku": "SKUWfs6055469496189", "quantity": 1, "productName": "Boys tshirt", "hsCode": "12332412", "originState": "Delhi", "originCity": "Delhi", "countryOfOrigin": "IN" } ], "fromAddress": { "contactName": "Test Seller", "companyName": "Test Company", "addressLine1": "Add1", "addressLine2": "Add2", "city": "Bangalore", "state": "Karanataka", "postalCode": "560100", "country": "IN", "phone": "2074193432", "email": "[email protected]" }, "purchaseOrderId": "108913539040341", "carrierName": "FedEx", "carrierServiceType": "FEDEX_INTERNATIONAL_PRIORITY", "hazmat": false
}
'

Response Samples

application/json

200 Sample 1

{ "data": { "purchaseOrderId": "97108719025934786", "trackingNo": "10015361751436", "boxItems": [ { "sku": "PRECISE3PGLASS9", "quantity": 1, "lineNumber": "1" } ], "carrierName": "FedEx", "carrierFullName": "FedEx", "carrierServiceType": "FedEx 2Day", "trackingUrl": "https://www.fedex.com/apps/fedextrack/?action=track&tracknumbers=10015361751436&locale=en_US&cntry_code=us" }
}

200 - Sample 2

{ "data": { "purchaseOrderId": "97108719025934786", "trackingNo": "10015361751436", "boxItems": [ { "sku": "PRECISE3PGLASS9", "quantity": 1, "lineNumber": "1" } ], "carrierName": "FedEx", "carrierFullName": "FedEx", "carrierServiceType": "FedEx 2Day", "trackingUrl": "https://www.fedex.com/apps/fedextrack/?action=track&tracknumbers=10015361751436&locale=en_US&cntry_code=us", "addOns": [ { "name": "INSURANCE", "charge": { "amount": 0.32, "currency": "USD" }, "declaredValue": { "amount": 40, "currency": "USD" }, "refLink": "https://docs.google.com/forms/d/e/1FAIpQLSfptruFTsLSkL2T3xi50m3BZn6xFHApbliZqucpIxSYqVXEvA/viewform?pli=1", "status": "Active" }, { "name": "SIGNATURE", "charge": { "amount": 6.35, "currency": "USD" }, "status": "Active" } ] }
}

200 - Sample 5

{ "data": { "purchaseOrderId": "108919840486078", "trackingNo": "100625040279", "boxItems": [ { "sku": "SKUWfs6055469496189", "quantity": 1, "lineNumber": "1" } ], "carrierName": "FedEx", "carrierFullName": "FedEx", "carrierServiceType": "FedEx Express Saver", "trackingUrl": "https://www.fedex.com/apps/fedextrack/?action=track&tracknumbers=100625040279&locale=en_US&cntry_code=us" }
}

application/pdf

200

{ "data": { "purchaseOrderId": "string", "trackingNo": "string", "boxItems": [ { "sku": "string", "quantity": 0, "lineNumber": "string", "productName": "string", "productNameInLocale": "string", "hsCode": "string", "originState": "string", "originCity": "string", "countryOfOrigin": "string" } ], "carrierName": "string", "carrierFullName": "string", "carrierServiceType": "string", "trackingUrl": "string", "addOns": [ { "name": "SIGNATURE", "charge": { "amount": 0, "currency": "AED" }, "declaredValue": { "amount": 0, "currency": "AED" }, "refLink": "string", "status": "string" } ] }, "errors": [ { "info": "string", "code": "string", "field": "string", "description": "string", "severity": "EMERG", "category": "APPLICATION", "httpStatus": 0 } ]
}

image/png

200

{ "data": { "purchaseOrderId": "string", "trackingNo": "string", "boxItems": [ { "sku": "string", "quantity": 0, "lineNumber": "string", "productName": "string", "productNameInLocale": "string", "hsCode": "string", "originState": "string", "originCity": "string", "countryOfOrigin": "string" } ], "carrierName": "string", "carrierFullName": "string", "carrierServiceType": "string", "trackingUrl": "string", "addOns": [ { "name": "SIGNATURE", "charge": { "amount": 0, "currency": "AED" }, "declaredValue": { "amount": 0, "currency": "AED" }, "refLink": "string", "status": "string" } ] }, "errors": [ { "info": "string", "code": "string", "field": "string", "description": "string", "severity": "EMERG", "category": "APPLICATION", "httpStatus": 0 } ]
}

Result

A Create label response returns shipment details in the data object. The API response includes the tracking number, and you can return JSON, PDF, or image output based on the accept header.

Sample 1 returns the purchase order ID, tracking number, shipped items, carrier name, carrier service, and tracking URL for a FedEx 2-day shipment.
Sample 2 returns the same shipment details and also includes the selected add-ons with charge, declared value, reference link, and status.
Sample 5 returns the shipment details for a FedEx Express Saver label, including the tracking number and tracking URL.
The PDF sample shows the response shape of flows for the PDF output.
The PNG sample shows the response shape for the PNG output.

Next Steps

The Shipping estimates API provides the best rate to ship an order.

The Label details by purchase order ID API procures shipping label information on multiple orders such as label generation, carrier service type, shipment tracking, shipment protection, and signature protection.

The Supported carriers API provides a list of Walmart's approved carriers to ship orders.

The Download label API retrieves a carrier label by the carrier and tracking number.

The Discard label API removes shipping labels.

The Supported carrier package types API provides package types the carrier offers.

The Create scan form for labels API creates a scan form (also called a shipping manifest) to group multiple labels together for a carrier to scan a single document at pickup.

The Download scan form API downloads a scan form document from the manifestId.

The Get ship-on-date API provides recommendations for the default ship-on-date and maximum ship-on-date on seller orders.