Guides
My Account

Update account level settings

Overview

The Update account level settings API allows sellers to configure account-level calendar settings that impact shipping calculations and delivery promise logic.

Endpoint

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

Function

This API enables you to:

  • Define whether Saturday and Sunday are working days
  • Add or remove specific calendar override dates
  • Manage additional non-working days such as holidays and blackout dates
  • Control carrier weekend schedule transit time

These settings directly influence the order processing timelines and shipping promise calculations across your account. Adding days off at the account level ensures your fulfillment centers remain closed for operations on nonworking days. If you need separate holidays for individual fulfillment centers, you can configure the holidays in the Create fulfillment center or Update fulfillment center APIs. As a Marketplace seller, you can configure up to 30 additional days off in a calendar year.

Sample request

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "calendarDayConfiguration": { "carrierWeekendCalendar": { "saturday": { "workingDay": true }, "sunday": { "workingDay": false } }, "calendarDayOffOverrides": [ { "overrideDate": "2030-03-10", "actionType": "ADD" }, { "overrideDate": "2024-04-10", "actionType": "REMOVE" } ] }
}
'

Modify your code

1. Add authentication

Include a valid OAuth access token or your required authentication header:

--header 'Authorization: Bearer <ACCESS_TOKEN>'

If your integration requires additional headers (such as consumer ID or correlation ID), include them accordin2gly.

2. Understand override behavior

  • ADD: Adds a date to additionalDaysOff
  • REMOVE: Removes a previously configured date
  • Weekend working days affect shipping transit logic

Ensure:

  • Dates follow the YYYY-MM-DD format
  • Past dates are valid for your system rules
  • You are not adding duplicate override entries

Sample response

{ "calendarDayConfiguration": { "carrierWeekendCalendar": { "saturday": { "workingDay": true }, "sunday": { "workingDay": false } }, "additionalDaysOff": [ "2030-03-10" ] }
}

Result

  • The account-level calendar configuration has been updated.
  • Saturday is configured as a working day.
  • Sunday is configured as a non-working day.
  • The date 2030-03-10 has been added to additionalDaysOff.
  • The override date 2024-04-10 is removed as requested.

These changes will immediately affect:

  • Transit time calculations
  • Delivery promise logic
  • Order processing schedules

Next steps

The Get shipping template details API gives you specific shipping configurations for a single shipping template.

The Update shipping templates API lets you modify configurations on an existing shipping template, such as shipping methods, regions, transit times, and pricing rules.

The Delete shipping templates API lets you permanently remove existing shipping templates from Walmart Marketplace settings.

The Get all fulfillment centers API retrieves fulfillment centers (also known as ship nodes) information on your account.

The Update fulfillment center API helps you update your existing fulfillment centers (also known as a ship nodes) configuration in Marketplace Settings.

The Create fulfillment center API sets up new fulfillment centers (also known as ship nodes) in Walmart Marketplace Settings.

The Get account level settings API retrieves account-level shipping settings such as calendar day configurations, weekends, and additional days off.

The Create account level settings API lets you establish account level calendar configuration for your shipping operations.

The Get all shipping templates API retrieves a list of all shipping templates configured on your account.

The Create shipping templates API allows sellers to create custom shipping templates that define shipping methods, transit times, pricing logic, and geographic coverage.

The Third-party fulfillment center association API allows sellers to activate or update the status of 3PL (third-party logistics) ship nodes associated with your Marketplace account.

The Get shipping configurations API retrieves account-level shipping profile settings associated on your account.

The Get shipping template activation status API allows sellers to retrieve the current activation state of shipping templates at the account level.

The Get coverage for fulfillment centers API retrieves the geographic coverage areas associated with each fulfillment center (ship node) configured under a seller account.

The Get carrier methods API retrieves the list of carrier methods available for use in Marketplace shipping configurations

The Get all third-party fulfillment providers API retrieves all third-party fulfillment providers (3PLs) available on the Walmart marketplace.

The Get partner configurations API retrieves seller-level profile information and system configuration settings associated with a Marketplace partner account.


Updated about 12 hours ago