Token API

post

https://marketplace.walmartapis.com/v3/token

Migrate to Global APIs: New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore Global Marketplace migration resources.

Get access token by providing Client ID and Client Secret.
An access token expires after a certain interval, so you will have to refresh a user's access token. You could use refresh token, obtained from the token API call using authorization code grant type, to get a new access token. Refresh tokens remain valid for a year.

[Guide reference - authorization_code](/doc/cl/cl-mp/cl-mp-auth/)

[Guide reference - refresh_token](/doc/cl/cl-mp/cl-mp-auth/)

[Guide reference - client_credentials](/doc/cl/cl-mp/cl-mp-auth/)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Form Data

grant_type

string

enum

required

Defaults to client_credentials

Type of grant requested.
Available grant types: authorization_code, refresh_token and client_credentials

Allowed:

code

string

Defaults to 65CA5DA313A549D49D15D3119D9AD85D

Authorization code obtained by your client app when the seller authorizes your app to access the seller resource.
This field is required when grant_type: authorization_code

redirect_uri

string

Defaults to https://example-client-app.com

This should be same as one of your client app URIs provided while registering the app.
This field is required when grant_type: authorization_code

refresh_token

string

Defaults to APXcIoTpKMH9OQN.....

Refresh token received as response of Authentication API with authorization_code grant type, to be used to refresh the access token.
This field is required when grant_type: refresh_token

Headers

WM_PARTNER.ID

string

Partner Id registered in Walmart marketplace to identify a seller.
This field is required when grant_type: authorization_code and grant_type: refresh_token

WM_MARKET

string

required

Available marketplace location: us (USA), mx (Mexico), ca (Canada) or cl (Chile)

Authorization

string

required

Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.

WM_CONSUMER.CHANNEL.TYPE

string

A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding.

WM_QOS.CORRELATION_ID

string

required

A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID

WM_SVC.NAME

string

required

Walmart Service Name

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Response

200Successful Operation