Guides
My Account

Update Simplified Shipping Settings

Overview

The Update Simplified Shipping Settings API helps sellers and approved solution providers modify their existing default shipping configuration as business needs evolve. Since the default setting typically covers the majority of your assortment and fulfillment centers, updates through this API automatically cascade to all items governed in the configuration. This enables sellers to efficiently adjust carrier selections, regional coverages or shipping charges without manual remapping, while still retaining the flexibility to maintain separate custom configurations where needed.

Functionality

Sellers and approved Solution Providers use this API endpoint to update account-level Simplified Shipping Settings configurations for all fulfillment centers. You can update settings within the accountConfigs object to modify configurations, such as changing:

  • The carriers that are available for your items.
  • The regions that items are available in.

The endpoint returns an updated version of the simplifiedShippingSettings map of the Simplified Shipping Settings configurations.

Endpoint

PUT <https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account>

Sample request

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateFreeShippingOffers": true, "carrierConfigs": [ { "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" }, "chargePerItem": { "amount": 0, "currency": "USD" } } } } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionName": "AK and HI", "regionCode": "H" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 2, "currency": "USD" }, "chargePerWeight": { "amount": 5, "currency": "USD" } } } } ] }, { "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_3DAY_SELECT" } ], "configurations": [ { "regions": [ { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

Sample 1 - Carrier Configuration

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateFreeShippingOffers": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_PRIORITY_MAIL_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" } } } } ] } ] } }
}
'

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

Sample 2 - Carrier Configuration

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateFreeShippingOffers": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_PRIORITY_MAIL_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" } } } } ] } ] } }
}
'

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

Sample 3 - Invalid Carrier Name

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateFreeShippingOffers": true, "carrierConfigs": [ { "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" } } } } ] }, { "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" } } } } ] } ] } }
}
'

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

Sample 4 - Shipping Charge object is empty

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

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

Sample 5 - Valid subtype of shippingCharge object not present

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateFreeShippingOffers": true, "carrierConfigs": [ { "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" } } ] } ] } }
}
'

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

Sample 6 - Shipping charge amount cannot exceed 700

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateFreeShippingOffers": true, "carrierConfigs": [ { "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" } } } } ] } ] } }
}
'

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

Sample request - Duplicate regions are not allowed for same carrier at account level

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "carrierConfigs": [ { "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" } } } } ] } ] } }
}
'

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

Modify your code

Follow these steps to call this API and receive the responses provided:

  1. Add authentication headers: Include your valid access token header (example, WM_SEC.ACCESS_TOKEN: <YourAccessToken> or standard Authorization: Bearer depending on your integration).
  2. Include required marketplace headers: Samples include WM_GLOBAL_VERSION and WM_MARKET. Keep Accept: application/json and Content-Type: application/json.
  3. Validate the JSON payload. Ensure there are no syntax issues (duplicate opening braces) and the payload conforms to allowed enums for carrierName, carrierService, regionCode, regionName, and addressTypes.
  4. Check region/state coverage rules. Account-level coverage typically must include all 48 states + DC when certain carrier/services require full coverage. If account-level coverage is incomplete, you will receive an INVALID_REQUEST_CONTENT.INVALID_REQUEST error.
  5. Watch for seller eligibility constraints. Requests may fail if the seller has unsupported conditions (3PL nodes, bundle items, international nodes, etc.).
  6. This API may return errors in the response body even with an HTTP 200 code. Always inspect the response body for an errors array.

Example: Add access token and market headers:

curl --request PUT \ --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 @payload.json 
import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response

{ "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateFreeShippingOffers": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_3DAY_SELECT" } ], "configurations": [ { "regions": [ { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "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" }, "chargePerItem": { "amount": 0, "currency": "USD" } } } } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 2, "currency": "USD" }, "chargePerWeight": { "amount": 5, "currency": "USD" } } } } ] } ] } }
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response 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": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response invalid carrier configs

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

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response 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": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response invalid coverage 2

{ "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": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response invalid region combination

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "regionCode and regionName", "description": "Invalid region code: P and region name: US Protectorate 6s combination", "info": "Invalid region code: P and region name: US Protectorate 6s combination", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response 3PL node

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "We noticed you have 3PL fulfillment centers which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.", "info": "We noticed you have 3PL fulfillment centers which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response bundle items

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Seller with Bundles: We noticed you have Bundle items which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later", "info": "Seller with Bundles: We noticed you have Bundle items which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response international nodes

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "We noticed you have international fulfillment centers which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.", "info": "We noticed you have international fulfillment centers which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 – Sample response major applications

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "We noticed you are enabled for Major Appliances program which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.", "info": "We noticed you are enabled for Major Appliances program which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 - Sample - Invalid Carrier Name

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierName", "description": "Invalid Carrier Name", "info": "Invalid Carrier Name", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 - Sample - Shipping Charge Object Is Empty

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "shippingCharges", "description": "Shipping charge object cannot be empty", "info": "Shipping charge object cannot be empty", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 - Sample - Valid Subtype Of Shipping Charge Object Not Present

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "shippingCharges", "description": "Provide the shipping charges in perShippingCharges", "info": "Provide the shipping charges in perShippingCharges", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 - Sample - Shipping Charge Amount Cannot Exceed 700

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "perShippingCharge", "description": "Shipping charge amount can't exceed the max allowed limit 700", "info": "Shipping charge amount can't exceed the max allowed limit 700", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

200 - Sample - Duplicate Regions Not Allowed at FC Level

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "shippingCharges", "description": "Duplicate regions are not allowed at account Level for carrier and node", "info": "Duplicate regions are not allowed at account Level for carrier and node", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

import requests
import json # Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account" # Replace the placeholder values with your own
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token "WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call "WM_SVC.NAME": "Walmart Service Name"
} payload = { "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateEligibleOffers": False, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": ["STREET"] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": ["STREET"] } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "P", "regionName": "US Protectorate 6s" } ], "addressTypes": ["PO_BOX", "STREET"] } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))

Result

  • In a successful response, the API returns an updated account-level simplifiedShippingSettings object.
  • In validation errors, the API returns structured errors explaining which field and why the request failed (even if HTTP 200 is returned in some integrations).
  • Account-level settings establish the default coverage and capabilities. Fulfillment center level overrides can supersede these when configured.

Next steps

  • Validate the JSON payload: Fix duplicate braces, invalid enums, and duplicate state codes before calling.
  • Confirm seller eligibility: Remove or resolve unsupported conditions (3PL nodes, bundle items, international nodes) or check for upcoming feature support.
  • Test via Get Simplified Shipping Settings: Fetch account settings after update to verify changes.
  • Test order/checkout scenarios: Ensure delivery promises and rates reflect the new settings.
  • Monitor error responses: Implement logging and retries for transient issues and clear validation failures before re-submission.

Updated 20 days ago