Guides
My Account
  1. Simplified Shipping Settings
  2. Simplified Shipping Settings API overview

Create Simplified Shipping Settings

Important: Sellers who integrated with these APIs prior to October 14, 2026 will need to update their integration to the latest API version to ensure compatibility.

Overview

The Create Simplified Shipping Settings API enables sellers and solution providers to seamlessly onboard to Simplified Shipping Settings by creating a default shipping configuration. The default configuration covers the majority of your assortments in your fulfillment centers, applying automatically to eligible items, and eliminating any template-to-item mappings. You can add custom configurations for specific items or fulfillment centers with different shipping rules.

Function

Call this endpoint to create an account-level shipping rule for Simplified Shipping Settings. This rule applies to every fulfillment center in your network and specifies:

  • Which carriers you want to use.
  • The regions you want the carriers to cover.
  • Your shipping priority: The fastest delivery or cost savings

Optionally, in the same call, you can direct Walmart to migrate any offers that qualify for Simplified Shipping Settings free shipping in the 48 contiguous US states, Alaska, Hawaii, Puerto Rico, Guam, American Samoa, US Virgin Islands, and the Northern Mariana Islands.

Endpoint

POST https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account

Sample requests

Sample Request

Sample Request

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "migrateEligibleOffers": false, "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_GROUND" }, { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] }, { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" }, { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] }, { "shippingMethod": "EXPEDITED", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_2DAY_AIR" }, { "carrierName": "Fedex", "carrierService": "FEDEX_2DAY_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 12.99, "currency": "USD" }, "chargePerWeight": { "amount": 2, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" }, { "carrierName": "UPS", "carrierService": "UPS_NEXTDAY_AIR" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 24.99, "currency": "USD" }, "chargePerWeight": { "amount": 3, "currency": "USD" } } } } ] } ] } }
}
'

Sample Request - Duplicate shippingMethod (account level)

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_SUREPOST" } ], "configurations": [ { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'

Sample 1 - Carrier Configuration

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'

Sample 2 - Carrier Configuration

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 2, "currency": "USD" } } } } ] } ] } }
}
'

Sample Request - 48 States + DC free shipping not covered across shipping methods

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "NE", "states": [ { "stateCode": "NY", "stateName": "New York" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 3, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] } ] } }
}
'

Sample - Carrier Configuration

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_SUREPOST" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "EXPEDITED", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_2DAY_AIR" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NM", "stateName": "New Mexico" }, { "stateCode": "MT", "stateName": "Montana" }, { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "WA", "stateName": "Washington" }, { "stateCode": "CO", "stateName": "Colorado" }, { "stateCode": "OR", "stateName": "Oregon" }, { "stateCode": "ID", "stateName": "Idaho" }, { "stateCode": "WY", "stateName": "Wyoming" }, { "stateCode": "AZ", "stateName": "Arizona" }, { "stateCode": "CA", "stateName": "California" }, { "stateCode": "UT", "stateName": "Utah" } ] }, { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] }, { "subRegionCode": "MW", "states": [ { "stateCode": "ND", "stateName": "North Dakota" }, { "stateCode": "IA", "stateName": "Iowa" }, { "stateCode": "KS", "stateName": "Kansas" }, { "stateCode": "NE", "stateName": "Nebraska" }, { "stateCode": "MO", "stateName": "Missouri" }, { "stateCode": "IL", "stateName": "Illinois" }, { "stateCode": "IN", "stateName": "Indiana" }, { "stateCode": "MN", "stateName": "Minnesota" }, { "stateCode": "OH", "stateName": "Ohio" }, { "stateCode": "MI", "stateName": "Michigan" }, { "stateCode": "WI", "stateName": "Wisconsin" }, { "stateCode": "SD", "stateName": "South Dakota" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] }, { "subRegionCode": "MW", "states": [ { "stateCode": "ND", "stateName": "North Dakota" }, { "stateCode": "IA", "stateName": "Iowa" }, { "stateCode": "KS", "stateName": "Kansas" }, { "stateCode": "NE", "stateName": "Nebraska" }, { "stateCode": "MO", "stateName": "Missouri" }, { "stateCode": "IL", "stateName": "Illinois" }, { "stateCode": "IN", "stateName": "Indiana" }, { "stateCode": "MN", "stateName": "Minnesota" }, { "stateCode": "OH", "stateName": "Ohio" }, { "stateCode": "MI", "stateName": "Michigan" }, { "stateCode": "WI", "stateName": "Wisconsin" }, { "stateCode": "SD", "stateName": "South Dakota" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] }, { "subRegionCode": "MW", "states": [ { "stateCode": "ND", "stateName": "North Dakota" }, { "stateCode": "IA", "stateName": "Iowa" }, { "stateCode": "KS", "stateName": "Kansas" }, { "stateCode": "NE", "stateName": "Nebraska" }, { "stateCode": "MO", "stateName": "Missouri" }, { "stateCode": "IL", "stateName": "Illinois" }, { "stateCode": "IN", "stateName": "Indiana" }, { "stateCode": "MN", "stateName": "Minnesota" }, { "stateCode": "OH", "stateName": "Ohio" }, { "stateCode": "MI", "stateName": "Michigan" }, { "stateCode": "WI", "stateName": "Wisconsin" }, { "stateCode": "SD", "stateName": "South Dakota" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'

Sample 2 - Carrier Configuration

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] }, { "subRegionCode": "MW", "states": [ { "stateCode": "ND", "stateName": "North Dakota" }, { "stateCode": "IA", "stateName": "Iowa" }, { "stateCode": "KS", "stateName": "Kansas" }, { "stateCode": "NE", "stateName": "Nebraska" }, { "stateCode": "MO", "stateName": "Missouri" }, { "stateCode": "IL", "stateName": "Illinois" }, { "stateCode": "IN", "stateName": "Indiana" }, { "stateCode": "MN", "stateName": "Minnesota" }, { "stateCode": "OH", "stateName": "Ohio" }, { "stateCode": "MI", "stateName": "Michigan" }, { "stateCode": "WI", "stateName": "Wisconsin" }, { "stateCode": "SD", "stateName": "South Dakota" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'

Sample V2 - Multiple shippingMethods (Explode)

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "EXPEDITED", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'

Sample 3 - Invalid Carrier Name

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "test", "carrierService": "testService" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionName": "AK and HI", "regionCode": "H" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerItem": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'

Sample 4 - Shipping Charge is empty

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionName": "AK and HI", "regionCode": "H" } ], "addressTypes": [ "STREET" ] } ] } ] } }
}
'

Sample 5 - Valid subtype of shippingCharge object not present

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionName": "AK and HI", "regionCode": "H" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING" } } ] } ] } }
}
'

Sample 6 - Shipping charge amount cannot exceed 700

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionName": "AK and HI", "regionCode": "H" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerItem": { "amount": 780, "currency": "USD" } } } } ] } ] } }
}
'

Sample 8 - Duplicate regions for same carrier is not allowed at account level

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerItem": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 10, "currency": "USD" }, "chargePerWeight": { "amount": 20, "currency": "USD" } } } } ] } ] } }
}
'

Modify your request

To successfully create settings, make the following modifications:

  1. Authentication: Include your token header (example header used elsewhere: WM_SEC.ACCESS_TOKEN: <YourAccessToken> or use your agreed auth header).
  2. Required headers: Include WM_GLOBAL_VERSION and WM_MARKET as shown. Always set Accept: application/json and Content-Type: application/json.
  3. Payload validity: Copy-paste one of the sample JSON bodies above (exactly as supplied) into data or a file and reference it (--data @payload.json). Do not insert duplicate braces or syntax errors.
  4. Carrier/service validation. Ensure carrierService values are supported for the specified carrierName. Unsupported combos can return an invalid carrier configuration error.
  5. Coverage rules. If the selected carrier requires full state coverage, include all 48 states + DC or adjust carrier choices accordingly to avoid All 48 states + DC are not covered errors.
  6. No duplicate state codes. Make sure stateCode values are unique. Duplicate state codes produce astateCodes error.
  7. Seller eligibility constraints: If your seller account has 3PL nodes, bundles, international nodes, or is enrolled in major applications, the request will be rejected. Remove unsupported configurations or contact support.

Example:

curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account' \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: us' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'WM_SEC.ACCESS_TOKEN: <YourAccessToken>' \ --data @create_simplified_shipping_payload.json

Sample responses

application/json

200 - Sample Response

{ "simplifiedShippingSettings": { "accountConfigs": { "migrateEligibleOffers": false, "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_GROUND" }, { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] }, { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" }, { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] }, { "shippingMethod": "EXPEDITED", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_2DAY_AIR" }, { "carrierName": "Fedex", "carrierService": "FEDEX_2DAY_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 12.99, "currency": "USD" }, "chargePerWeight": { "amount": 2, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" }, { "carrierName": "UPS", "carrierService": "UPS_NEXTDAY_AIR" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 24.99, "currency": "USD" }, "chargePerWeight": { "amount": 3, "currency": "USD" } } } } ] } ] } }
}

200 - Sample - Duplicate State Codes

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "stateCode", "description": "Duplicate stateCodes for: CT", "info": "Duplicate stateCodes for: CT", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Conflicting Regions Within Same ShippingMethod (VALUE)

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierConfigs", "description": "Multiple shipping rules cannot be set across the same carrier service and region combination.", "info": "Ensure no conflicting carrier configurations exist for the same shippingMethod, carrierService, region, and addressType combination.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - 48 States + DC Free Shipping Not Covered Across Shipping Methods

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "configurations", "description": "Free shipping must cover all 48 states + DC at account level. Ensure at least one carrier configuration offers free (zero-charge) shipping across all 48 contiguous states and Washington DC.", "info": "Free shipping must cover all 48 states + DC at account level. Ensure at least one carrier configuration offers free (zero-charge) shipping across all 48 contiguous states and Washington DC.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Invalid Carrier Configs

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierName", "description": "Provided carrier service is not valid.", "info": "Provide a valid carrier service.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Invalid Coverage

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierConfigs", "description": "The provided coverage for the given carrier service is not supported: `USPS_PRIORITY_MAIL_EXPRESS`", "info": "The provided coverage for the given carrier service is not supported: `USPS_PRIORITY_MAIL_EXPRESS`", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Invalid Coverage 2

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierName", "description": "Provided carrier service is not valid.", "info": "Provide a valid carrier service.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Invalid Region Combination

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierConfigs", "description": "The provided coverage for the given carrier service is not supported: `USPS_PRIORITY_MAIL_EXPRESS`", "info": "The provided coverage for the given carrier service is not supported: `USPS_PRIORITY_MAIL_EXPRESS`", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Settings Already Exists

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "states/stateCode", "description": "All 48 states + DC are not covered at account level", "info": "All 48 states + DC are not covered at account level", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - 3PL Node

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account has 3PL fulfillment centers, which Simplified Shipping Settings does not currently support. Support for 3PL fulfillment centers is in development. Check back later for updates.", "info": "Your account has 3PL fulfillment centers, which Simplified Shipping Settings does not currently support. Support for 3PL fulfillment centers is in development. Check back later for updates.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Bundle Items

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account has bundle items, which Simplified Shipping Settings does not currently support. Support for bundle items is in development. Check back later for updates", "info": "Your account has bundle items, which Simplified Shipping Settings does not currently support. Support for bundle items is in development. Check back later for updates", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - International Nodes

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account has international fulfillment centers, which Simplified Shipping Settings currently do not support. Support for international fulfillment centers is in development. Check back later for updates.", "info": "Your account has international fulfillment centers, which Simplified Shipping Settings currently do not support. Support for international fulfillment centers is in development. Check back later for updates.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Major Appliances

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account is enabled for Major Appliances program, which Simplified Shipping Settings currently do not support. Support for Major Appliances is in development. Check back later for updates.", "info": "Your account is enabled for Major Appliances program, which Simplified Shipping Settings currently do not support. Support for Major Appliances is in development. Check back later for updates.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Duplicate ShippingMethod (Account Level)

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierConfigs", "description": "Only one carrier configuration is allowed per shipping speed tier. All carriers within the same speed tier share the same region coverage and shipping rates. To set different rates or coverages, add a separate speed tier (for example, `VALUE`, `STANDARD`, `EXPEDITED`). Duplicate `shippingMethod`: `STANDARD`", "info": "Only one carrier configuration is allowed per shipping speed tier. All carriers within the same speed tier share the same region coverage and shipping rates. To set different rates or coverages, add a separate speed tier (for example, `VALUE`, `STANDARD`, `EXPEDITED`). Duplicate `shippingMethod`: `STANDARD`", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Duplicate ShippingMethod (FC Level)

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierConfigs", "description": "Only one carrier configuration is allowed per shipping speed tier. All carriers within the same speed tier share the same region coverage and shipping rates. To set different rates or coverages, add a separate speed tier (e.g., `VALUE`, `STANDARD`, `EXPEDITED`). Duplicate `shippingMethod`: `STANDARD`", "info": "Only one carrier configuration is allowed per shipping speed tier. All carriers within the same speed tier share the same region coverage and shipping rates. To set different rates or coverages, add a separate speed tier (e.g., `VALUE`, `STANDARD`, `EXPEDITED`). Duplicate `shippingMethod`: `STANDARD`", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Carrier / ShippingMethod Mismatch

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierConfigs", "description": "Carrier does not belong to the specified `shippingMethod`. Mismatched carrier: `FEDEX_HOME_DELIVERY` belongs to `shippingMethod` `VALUE` but was assigned to `STANDARD`", "info": "Carrier does not belong to the specified `shippingMethod`. Mismatched carrier: `FEDEX_HOME_DELIVERY` belongs to `shippingMethod` `VALUE` but was assigned to `STANDARD`", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Carrier / ShippingMethod Mismatch (FC Level)

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierConfigs", "description": "Carrier does not belong to the specified `shippingMethod`. Mismatched carrier: `UPS_GROUND` belongs to `shippingMethod` `VALUE` but was assigned to `EXPEDITED`.", "info": "Carrier does not belong to the specified `shippingMethod`. Mismatched carrier: `UPS_GROUND` belongs to `shippingMethod` `VALUE` but was assigned to `EXPEDITED`.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Invalid Carrier Name

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account has international fulfillment centers, which Simplified Shipping Settings currently do not support. Support for international fulfillment centers is in development. Check back later for updates.", "info": "Your account has international fulfillment centers, which Simplified Shipping Settings currently do not support. Support for international fulfillment centers is in development. Check back later for updates.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Shipping Charge Object Is Empty

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account is enabled for Major Appliances program, which Simplified Shipping Settings currently do not support. Support for Major Appliances is in development. Check back later for updates.", "info": "Your account is enabled for Major Appliances program, which Simplified Shipping Settings currently do not support. Support for Major Appliances is in development. Check back later for updates.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Valid Subtype Of ShippingCharge Object Not Present

200 - Sample - Shipping Charge Amount Cannot Exceed 700

200 - Sample - Duplicate Regions Not Allowed At Account Level

401

{ "error": [ { "code": "UNAUTHORIZED.GMP_GATEWAY_API", "field": "UNAUTHORIZED", "description": "Unauthorized", "info": "Unauthorized token or incorrect authorization header. Verify the correct format: \"Authorization: Basic Base64Encode(clientId:clientSecret)\". For more information, refer to https://developer.walmart.com/#/apicenter/marketPlace/latest#apiAuthentication.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

application/problem+json

400

{ "type": "https://developer.walmart.com/doc/us-mp-sss/errors/invalid-request", "title": "Invalid Request", "status": 400, "detail": "The shippingMethod value 'OVERNIGHT' is not a valid enum member. Accepted values: VALUE, STANDARD, EXPEDITED, RUSH.", "instance": "/v3/settings/shipping/simplifiedshippingsettings/account"
}

403

{ "type": "https://developer.walmart.com/doc/us-mp-sss/errors/forbidden", "title": "Forbidden", "status": 403, "detail": "The authenticated principal does not have permission to create account-level shipping settings for this seller.", "instance": "/v3/settings/shipping/simplifiedshippingsettings/account"
}

500

{ "type": "https://developer.walmart.com/doc/us-mp-sss/errors/internal-error", "title": "Internal Server Error", "status": 500, "detail": "An unexpected error occurred while processing the request. Retry the request or contact support with the correlationId.", "instance": "/v3/settings/shipping/simplifiedshippingsettings/account"
}

Result

  • Success: Returns a simplifiedShippingSettings object reflecting account-level settings (carriers, configurations, regions, address types, shipping priority, migration flags). This setting become the global default for shipping unless overridden by fulfillment center level configurations.
  • Failure / Validation errors: The response includes any errors array describing the problem and the fields to fix.

Next steps

After you create your Simplified Shipping Settings configuration, use the Orders Management API to retrieve released orders and shipping recommendations:

Updated about 1 month ago

Did this page help you?