---
updatedAt: 2026-08-03T17:21:23.000Z
---

# Create label

<div class="amber-callout" aria-label="Migration notice"><p><strong>Migrate to Global APIs:</strong> New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore <a href ="https://developer.walmart.com/global-marketplace/docs/global-marketplace-apis" style="text-decoration: underline !important; font-weight: 700;">Global Marketplace migration resources</a>.</p></div><br> Create shipping label for items. The response to a successful call are of json,pdf or image type based on the media type passed in Accept header.For eg. 'Accept'='application/json,application/pdf' will result in pdf media type and'Accept'='application/json,image/png' as image media type and 'Accept'='application/json' as json response.

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-b29a5be8-246b-441d-b695-b4e04478f380?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-b29a5be8-246b-441d-b695-b4e04478f380%26entityType%3Dcollection%26workspaceId%3D956a886d-5b0c-4e87-a28b-d31688fc1cc8\"\n  target=\"_blank\"\n  style=\"text-decoration: none\"\n>\n  <button>\n    <img\n      src=\"https://run.pstmn.io/button.svg\"\n      alt=\"Run In Postman\"\n      style=\"width: 128px; height: 32px\"\n    />\n  </button>\n</a>"
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "title": "International Shipping",
    "description": "The International Shipment APIs which allows US sellers to ship items to Mexico internationally, via Ship With Walmart service."
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false,
    "explorer-enabled": true
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production URL"
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Sandbox URL"
    }
  ],
  "security": [
    {
      "basicScheme": []
    }
  ],
  "paths": {
    "/v3/shipping/labels": {
      "post": {
        "tags": [
          "International Shipping"
        ],
        "summary": "Create label",
        "description": "<div class=\"amber-callout\" aria-label=\"Migration notice\"><p><strong>Migrate to Global APIs:</strong> New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore <a href =\"https://developer.walmart.com/global-marketplace/docs/global-marketplace-apis\" style=\"text-decoration: underline !important; font-weight: 700;\">Global Marketplace migration resources</a>.</p></div><br> Create shipping label for items. The response to a successful call are of json,pdf or image type based on the media type passed in Accept header.For eg. 'Accept'='application/json,application/pdf' will result in pdf media type and'Accept'='application/json,image/png' as image media type and 'Accept'='application/json' as json response.",
        "operationId": "createLabel",
        "parameters": [
          {
            "name": "WM_MARKET",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "mx"
              ]
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "description": "Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Basic YzcyOTFjNmItNzI5MC00...."
          },
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "description": "The access token retrieved in the Token API call",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "description": "A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SVC.NAME",
            "description": "Walmart Service Name",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Service Name"
          },
          {
            "in": "header",
            "name": "Accept",
            "description": "Only supported Media Type : application/json",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "application/json"
          }
        ],
        "requestBody": {
          "description": "Label fields",
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "boxDimensions",
                  "boxItems",
                  "carrierName",
                  "carrierServiceType",
                  "fromAddress",
                  "packageType",
                  "purchaseOrderId"
                ],
                "type": "object",
                "properties": {
                  "packageType": {
                    "type": "string",
                    "description": "Package Type. Supported Package Types are - 'CUSTOM_PACKAGE', 'FEDEX_ENVELOPE', 'FEDEX_PAK'"
                  },
                  "boxDimensions": {
                    "required": [
                      "boxWeight",
                      "boxWeightUnit"
                    ],
                    "type": "object",
                    "properties": {
                      "boxDimensionUnit": {
                        "type": "string",
                        "description": "Box Dimension Unit [CM, IN]. Mandatory for CUSTOM_PACKAGE type, otherwise not required",
                        "enum": [
                          "CM",
                          "IN"
                        ]
                      },
                      "boxWeightUnit": {
                        "type": "string",
                        "description": "Box Weight Unit [LB, KG]",
                        "enum": [
                          "LB",
                          "KG"
                        ]
                      },
                      "boxWeight": {
                        "type": "number",
                        "description": "Box Weight"
                      },
                      "boxLength": {
                        "type": "number",
                        "description": "Box Length. Mandatory for CUSTOM_PACKAGE type, otherwise not required"
                      },
                      "boxWidth": {
                        "type": "number",
                        "description": "Box Width. Mandatory for CUSTOM_PACKAGE type, otherwise not required"
                      },
                      "boxHeight": {
                        "type": "number",
                        "description": "Box Height. Mandatory for CUSTOM_PACKAGE type, otherwise not required"
                      }
                    },
                    "description": "Box Dimensions"
                  },
                  "boxItems": {
                    "type": "array",
                    "description": "Box Items",
                    "items": {
                      "required": [
                        "lineNumber",
                        "quantity",
                        "sku"
                      ],
                      "type": "object",
                      "properties": {
                        "sku": {
                          "type": "string",
                          "description": "sku of an item"
                        },
                        "quantity": {
                          "type": "integer",
                          "description": "Quantity of Item",
                          "format": "int32"
                        },
                        "countryOfOrigin": {
                          "type": "string",
                          "description": "Country of origin (country code) of item"
                        },
                        "lineNumber": {
                          "type": "string",
                          "description": "primeLineNo from MX order's response"
                        }
                      },
                      "description": "Box Items"
                    }
                  },
                  "fromAddress": {
                    "required": [
                      "addressLine1",
                      "city",
                      "contactName",
                      "country",
                      "phone",
                      "postalCode",
                      "state"
                    ],
                    "type": "object",
                    "properties": {
                      "contactName": {
                        "type": "string",
                        "description": "Contact name"
                      },
                      "companyName": {
                        "type": "string",
                        "description": "Company name"
                      },
                      "addressLine1": {
                        "type": "string",
                        "description": "Address Line 1"
                      },
                      "addressLine2": {
                        "type": "string",
                        "description": "Address Line 2"
                      },
                      "city": {
                        "type": "string",
                        "description": "city"
                      },
                      "state": {
                        "type": "string",
                        "description": "state"
                      },
                      "postalCode": {
                        "type": "string",
                        "description": "postal code"
                      },
                      "country": {
                        "type": "string",
                        "description": "country"
                      },
                      "phone": {
                        "type": "string",
                        "description": "phone"
                      },
                      "email": {
                        "type": "string",
                        "description": "email"
                      }
                    },
                    "description": "From Address"
                  },
                  "purchaseOrderId": {
                    "type": "string",
                    "description": "Purchase Order Id"
                  },
                  "carrierName": {
                    "type": "string",
                    "description": "Carrier Name. For now, the only supported carrier is - 'FedEx'"
                  },
                  "carrierServiceType": {
                    "type": "string",
                    "description": "Carrier Service Type. For now, supported values are - 'FEDEX_INTERNATIONAL_PRIORITY' for fedExPak/fedExEnvelope package types, 'FEDEX_INTERNATIONAL_ECONOMY' and 'FEDEX_INTERNATIONAL_GROUND'"
                  }
                }
              },
              "example": {
                "packageType": "CUSTOM_PACKAGE",
                "boxDimensions": {
                  "boxDimensionUnit": "IN",
                  "boxWeightUnit": "LB",
                  "boxWeight": 1,
                  "boxLength": 100,
                  "boxWidth": 1,
                  "boxHeight": 1
                },
                "boxItems": [
                  {
                    "sku": "SKU_28072021",
                    "quantity": 1,
                    "countryOfOrigin": "US"
                  }
                ],
                "fromAddress": {
                  "contactName": "Test",
                  "companyName": "Walmart",
                  "addressLine1": "Add1",
                  "addressLine2": "Add2",
                  "city": "Anchorage",
                  "state": "AK",
                  "postalCode": "99501",
                  "country": "US",
                  "phone": "12253",
                  "email": "test@walmart.com"
                },
                "purchaseOrderId": "P100569013",
                "carrierName": "FedEx",
                "carrierServiceType": "FEDEX_INTERNATIONAL_ECONOMY"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "purchaseOrderId": {
                          "type": "string",
                          "description": "Purchase Order Id "
                        },
                        "trackingNo": {
                          "type": "string",
                          "description": "Tracking Number"
                        },
                        "boxItems": {
                          "type": "array",
                          "description": "Box Items",
                          "items": {
                            "required": [
                              "quantity",
                              "sku"
                            ],
                            "type": "object",
                            "properties": {
                              "sku": {
                                "type": "string",
                                "description": "sku of an item"
                              },
                              "quantity": {
                                "type": "integer",
                                "description": "Quantity of Item",
                                "format": "int32"
                              },
                              "lineNumber": {
                                "type": "string",
                                "description": "primeLineNo from orders response"
                              }
                            },
                            "description": "Box Items"
                          }
                        },
                        "carrierName": {
                          "type": "string",
                          "description": "Carrier Short Name"
                        },
                        "carrierFullName": {
                          "type": "string",
                          "description": "Carrier Full Name"
                        },
                        "carrierServiceType": {
                          "type": "string",
                          "description": "Carrier Service Type"
                        },
                        "trackingUrl": {
                          "type": "string",
                          "description": "Tracking URL"
                        },
                        "shippingDocuments": {
                          "type": "object",
                          "properties": {
                            "documentFormat": {
                              "type": "string"
                            },
                            "documentType": {
                              "type": "string"
                            },
                            "base64EncodedDocument": {
                              "type": "string"
                            }
                          },
                          "description": "Shipping Documents"
                        }
                      },
                      "description": "data"
                    },
                    "errors": {
                      "type": "array",
                      "description": "errors",
                      "items": {
                        "type": "object",
                        "properties": {
                          "info": {
                            "type": "string",
                            "description": "error info"
                          },
                          "code": {
                            "type": "string",
                            "description": "error code"
                          },
                          "field": {
                            "type": "string",
                            "description": "field"
                          },
                          "description": {
                            "type": "string",
                            "description": "error description"
                          },
                          "severity": {
                            "type": "string",
                            "description": "error severity",
                            "enum": [
                              "EMERG",
                              "ALERT",
                              "CRITICAL",
                              "ERROR",
                              "WARN"
                            ]
                          },
                          "category": {
                            "type": "string",
                            "description": "error category",
                            "enum": [
                              "APPLICATION",
                              "SERVICE",
                              "REQUEST",
                              "DATA"
                            ]
                          },
                          "httpStatus": {
                            "type": "integer",
                            "description": "error http status",
                            "format": "int32"
                          }
                        },
                        "description": "errors"
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "purchaseOrderId": "P100569013",
                    "trackingNo": "019154094082",
                    "boxItems": [
                      {
                        "sku": "SKU_28072021",
                        "quantity": 1
                      }
                    ],
                    "carrierName": "FedEx",
                    "carrierFullName": "FedEx",
                    "carrierServiceType": "FedEx International Priority",
                    "trackingUrl": "https://www.fedex.com/apps/fedextrack/?action=track&tracknumbers=019154094082&locale=en_US&cntry_code=us",
                    "shippingDocuments": [
                      {
                        "documentFormat": "PDF",
                        "documentType": "LABEL",
                        "base64EncodedDocument": "JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9BdXRob3IgKE5lb2R5bmFtaWMgXCh3d3cubmVvZHluYW1pYy5jb21cKSkKL0NyZWF0b3IgKFpQTFByaW50ZXIgRW11bGF0b3IgU0RLIDQuMC4yMi40MjApCi9Qcm9kdWNlciAoWlBMUHJpbnRlciBFbXVsYXRvciBTREsgNC4wLjIyLjQyMCkKL1Byb2R1Y3Rpb25MaWJyYXJ5IChTa2lhL1BERiBtNjApCi9DcmVhdGlvbkRhdGUgKEQ6MjAyMzAzMTQxNDIwMjcrMDAnMDAnKT4"
                      }
                    ]
                  }
                }
              },
              "application/pdf": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "purchaseOrderId": {
                          "type": "string",
                          "description": "Purchase Order Id "
                        },
                        "trackingNo": {
                          "type": "string",
                          "description": "Tracking Number"
                        },
                        "boxItems": {
                          "type": "array",
                          "description": "Box Items",
                          "items": {
                            "required": [
                              "quantity",
                              "sku"
                            ],
                            "type": "object",
                            "properties": {
                              "sku": {
                                "type": "string",
                                "description": "sku of an item"
                              },
                              "quantity": {
                                "type": "integer",
                                "description": "Quantity of Item",
                                "format": "int32"
                              },
                              "lineNumber": {
                                "type": "string",
                                "description": "primeLineNo from orders response"
                              }
                            },
                            "description": "Box Items"
                          }
                        },
                        "carrierName": {
                          "type": "string",
                          "description": "Carrier Short Name"
                        },
                        "carrierFullName": {
                          "type": "string",
                          "description": "Carrier Full Name"
                        },
                        "carrierServiceType": {
                          "type": "string",
                          "description": "Carrier Service Type"
                        },
                        "trackingUrl": {
                          "type": "string",
                          "description": "Tracking URL"
                        },
                        "shippingDocuments": {
                          "type": "object",
                          "properties": {
                            "documentFormat": {
                              "type": "string"
                            },
                            "documentType": {
                              "type": "string"
                            },
                            "base64EncodedDocument": {
                              "type": "string"
                            }
                          },
                          "description": "Shipping Documents"
                        }
                      },
                      "description": "data"
                    },
                    "errors": {
                      "type": "array",
                      "description": "errors",
                      "items": {
                        "type": "object",
                        "properties": {
                          "info": {
                            "type": "string",
                            "description": "error info"
                          },
                          "code": {
                            "type": "string",
                            "description": "error code"
                          },
                          "field": {
                            "type": "string",
                            "description": "field"
                          },
                          "description": {
                            "type": "string",
                            "description": "error description"
                          },
                          "severity": {
                            "type": "string",
                            "description": "error severity",
                            "enum": [
                              "EMERG",
                              "ALERT",
                              "CRITICAL",
                              "ERROR",
                              "WARN"
                            ]
                          },
                          "category": {
                            "type": "string",
                            "description": "error category",
                            "enum": [
                              "APPLICATION",
                              "SERVICE",
                              "REQUEST",
                              "DATA"
                            ]
                          },
                          "httpStatus": {
                            "type": "integer",
                            "description": "error http status",
                            "format": "int32"
                          }
                        },
                        "description": "errors"
                      }
                    }
                  }
                }
              },
              "image/png": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "purchaseOrderId": {
                          "type": "string",
                          "description": "Purchase Order Id "
                        },
                        "trackingNo": {
                          "type": "string",
                          "description": "Tracking Number"
                        },
                        "boxItems": {
                          "type": "array",
                          "description": "Box Items",
                          "items": {
                            "required": [
                              "quantity",
                              "sku"
                            ],
                            "type": "object",
                            "properties": {
                              "sku": {
                                "type": "string",
                                "description": "sku of an item"
                              },
                              "quantity": {
                                "type": "integer",
                                "description": "Quantity of Item",
                                "format": "int32"
                              },
                              "lineNumber": {
                                "type": "string",
                                "description": "primeLineNo from orders response"
                              }
                            },
                            "description": "Box Items"
                          }
                        },
                        "carrierName": {
                          "type": "string",
                          "description": "Carrier Short Name"
                        },
                        "carrierFullName": {
                          "type": "string",
                          "description": "Carrier Full Name"
                        },
                        "carrierServiceType": {
                          "type": "string",
                          "description": "Carrier Service Type"
                        },
                        "trackingUrl": {
                          "type": "string",
                          "description": "Tracking URL"
                        },
                        "shippingDocuments": {
                          "type": "object",
                          "properties": {
                            "documentFormat": {
                              "type": "string"
                            },
                            "documentType": {
                              "type": "string"
                            },
                            "base64EncodedDocument": {
                              "type": "string"
                            }
                          },
                          "description": "Shipping Documents"
                        }
                      },
                      "description": "data"
                    },
                    "errors": {
                      "type": "array",
                      "description": "errors",
                      "items": {
                        "type": "object",
                        "properties": {
                          "info": {
                            "type": "string",
                            "description": "error info"
                          },
                          "code": {
                            "type": "string",
                            "description": "error code"
                          },
                          "field": {
                            "type": "string",
                            "description": "field"
                          },
                          "description": {
                            "type": "string",
                            "description": "error description"
                          },
                          "severity": {
                            "type": "string",
                            "description": "error severity",
                            "enum": [
                              "EMERG",
                              "ALERT",
                              "CRITICAL",
                              "ERROR",
                              "WARN"
                            ]
                          },
                          "category": {
                            "type": "string",
                            "description": "error category",
                            "enum": [
                              "APPLICATION",
                              "SERVICE",
                              "REQUEST",
                              "DATA"
                            ]
                          },
                          "httpStatus": {
                            "type": "integer",
                            "description": "error http status",
                            "format": "int32"
                          }
                        },
                        "description": "errors"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```