Guides
My Account

Create MCS sales channel details

Use this end point to set up a new sales channel in MCS. You can define:

  • Sales channel Name (e.g. your website, Amazon, eBay, Shein, Temu, etc.)
  • Ship from and return address: This is the business address that customers see on the shipping label. It’s also where we send back undeliverable shipments.

This page describes an example using only the required parameters and inputs for creating WFS order channel details. For a full list of customization options and additional capabilities, refer to the Walmart WFS API Reference.

Endpoint

`POST /v3/fulfillment/orders-fulfillments/channel-details`

Sample request

The sample request creates the fulfillment order channel details for a partner. The request includes authentication and context headers, and the JSON body specifies the partner ID, channel name, shipping methods, and return address.

curl --location 'https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/channel-details' \
--header 'loggedInUser: User name' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'martId: 202' \
--header 'WM_SEC.ACCESS_TOKEN: <accesstoken>' \
--header 'WM_QOS.CORRELATION_ID: Test Seller 105' \
--header 'WM_SVC.NAME: Walmart Marketplace' \
--data '{ "header": { "headerAttributes": { "martId": "202", "buId": "0" } }, "payload": { "partnerId": "10900075044", "mcsDetails": [ { "boxCatalogType": "multichannel", "orderChannelName": "External Shopify CHannel", "shippping": "FedX 2 Business Days and FedX Ground", "returnAddress": { "firstName": "Jomashop", "line1": "JOMASHOP", "line2": "140A 58TH ST UNIT 6N", "line3": "6TH FLOOR", "city": "BROOKLYN", "state": "NY", "country": "USA", "zip": "11220-2516", "addressType": "COMMERCIAL" } } ] }
}'

import requests url = "https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/channel-details"
headers = { "loggedInUser": "User name", "Accept": "application/json", "Content-Type": "application/json", "martId": "202", "WMSEC.ACCESSTOKEN": "<youraccesstoken>", #Replace with your actual access token "WMQOS.CORRELATIONID": "Test Seller 105", "WMSVC.NAME": "Walmart Marketplace"
}
data = { "header": { "headerAttributes": { "martId": "202", "buId": "0" } }, "payload": { "partnerId": "10900075044", "mcsDetails": [ { "boxCatalogType": "multichannel", "orderChannelName": "External Shopify CHannel", "shippping": "FedX 2 Business Days and FedX Ground", "returnAddress": { "firstName": "Jomashop", "line1": "JOMASHOP", "line2": "140A 58TH ST UNIT 6N", "line3": "6TH FLOOR", "city": "BROOKLYN", "state": "NY", "country": "USA", "zip": "11220-2516", "addressType": "COMMERCIAL" } } ] }
} response = requests.post(url, headers=headers, json=data)
print(response.statuscode)
print(response.json())

Modify your code

  • Replace WMSEC.ACCESSTOKEN with your actual access token
  • Use your unique WM_QOS.CORRELATION_ID for each request.
  • Use the unique partnerId that is assigned to the partner when making the request. This field is required and used to associate MCS details with a specific partner entity.

Sample response

This response indicates the API call was successful and the fulfillment order channel details were created as requested.

{ "status": "OK", "header": { "headerAttributes": {} }, "errors": [], "payload": [ { "orderChannelId": "A1B2C3D4E5F6G7H8I9J0", "boxCatalogType": "multichannel", "shippping": "FedX 2 Business Days and FedX Ground", "returnAddress": { "firstName": "Jomashop", "line1": "JOMASHOP", "line2": "140A 58TH ST UNIT 6N", "line3": "6TH FLOOR", "city": "BROOKLYN", "state": "NY", "country": "USA", "zip": "11220-2516", "addressType": "COMMERCIAL" }, "active": "Y", "sellerId": "10900075044", "sellerName": "Jomashop", "createdDate": "2024-06-01T12:00:00.000+00:00", "orderChannelName": "External Shopify CHannel", "martId": "202" } ]
}

Result

If successful, the API returns an HTTP status 200 OK with a JSON response. The response includes details of the created fulfillment order channel, such as the channel ID, shipping options, return address, seller information, and activation status.

Updated about 1 hour ago