Update pickup scheduling (New)

Call this endpoint to update a confirmed carrier pickup for an inbound Less Than Truckload (LTL) shipment by proposing a new date/time window and (optionally) updating pickup location or contact details. Use this endpoint to adjust the scheduled date for a confirmed carrier pickup of an inbound WPC shipment after a pickup has been booked. You can reschedule, update location, or contact information for a LTL shipment.

Note: This page shows examples using only the required parameters and inputs for updating pickup schedule for LTL shipments. For a full list of customization options and additional capabilities, refer to the Marketplace Fulfillment API Reference.

Endpoint

POST https://marketplace.walmartapis.com/v3/fulfillment/inbound-schedule-update

Sample request

This sample request demonstrates how to update the pickup schedule for LTL quote type.

curl --request POST \ --url https://marketplace.walmartapis.com/v3/fulfillment/inbound-schedule-update \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: US' \ --header 'WM_QOS.CORRELATION_ID: Correlation_ID' \ --header 'WM_SEC.ACCESS_TOKEN: Access_Token' \ --header 'WM_SVC.NAME: Walmart Service Name' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "payload": { "shipmentId": "0764456GDM", "bookingDetails": { "quoteType": "LTL", "quoteId": "1385226257027837952", "carrier": "CTII", "pickupDetails": { "pickupDateInfo": [ { "pickupDate": "2025-06-25", "readyTime": "00:00:00", "closeTime": "23:00:00", "priority": "1" } ], "pickupInstruction": "update" }, "contactDetails": { "firstname": "sdwefwe", "lastname": "bbb", "email": "[email protected]", "secondaryEmail": "string", "areaCode": "809", "number": "71980978", "extension": "124" }, "locations": { "origin": { "locationId": "0", "locationType": "VNDR", "addressLine1": "Main St", "addressLine2": "TEST", "city": "Vale", "state": "WI", "countryCode": "US", "postalCode": "95126" }, "destination": { "locationType": "DC", "addressLine1": "NORTH RIDGE TRAIL", "locationName": "", "city": "Davenport", "countryCode": "US", "state": "FL", "postalCode": "9512" } } } }
}
'

import requests url = "https://marketplace.walmartapis.com/v3/fulfillment/inbound-schedule-update" headers = { "WM_GLOBAL_VERSION": "3.1", "WM_MARKET": "US", "WM_QOS.CORRELATION_ID": "Correlation_ID", "WM_SEC.ACCESS_TOKEN": "Access_Token", "WM_SVC.NAME": "Walmart Service Name", "Accept": "application/json", "Content-Type": "application/json",
} json_data = { "payload": { "shipmentId": "0764456GDM", "bookingDetails": { "quoteType": "LTL", "quoteId": "1385226257027837952", "carrier": "CTII", "pickupDetails": { "pickupDateInfo": [ { "pickupDate": "2025-06-25", "readyTime": "00:00:00", "closeTime": "23:00:00", "priority": "1" } ], "pickupInstruction": "update" }, "contactDetails": { "firstname": "sdwefwe", "lastname": "bbb", "email": "[email protected]", "secondaryEmail": "string", "areaCode": "809", "number": "71980978", "extension": "124" }, "locations": { "origin": { "locationId": "0", "locationType": "VNDR", "addressLine1": "Main St", "addressLine2": "TEST", "city": "Vale", "state": "WI", "countryCode": "US", "postalCode": "95126" }, "destination": { "locationType": "DC", "addressLine1": "NORTH RIDGE TRAIL", "locationName": "", "city": "Davenport", "countryCode": "US", "state": "FL", "postalCode": "9512" } } } }
} response = requests.post(url, headers=headers, json=json_data)
print(response.status_code)
print(response.text)

Modify your code

Replace all placeholder values with your actual shipment data before making the API request.

Authorization - Replace with your actual Base64-encoded credentials.
WM_QOS.CORRELATION_ID - Use a unique correlation UUID to track the request.
WM_SEC.ACCESS_TOKEN - Replace with your valid access token obtained through authentication.

Sample response

This sample response shows the updated pick up details for the LTL shipment.

{ "payload": { "pickupConfirmationNumber": "PU-946-250610332", "pickupDate": "2025-06-25", "readyTime": "08:00:00", "closeTime": "17:00:00" }, "status": "OK"
}

Result

If the request is successful, the response returns a 200 OK status and provides detailed information about the updated shipment location.

Updated about 3 hours ago