Token API

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

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

Guide reference - refresh_token

Guide reference - client_credentials

time	status	user agent
Retrieving recent requests…

Loading…

Form Data

grant_type

string

required

Defaults to client_credentials

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

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

Authorization

string

required

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

Content-Type

string

required

Content type of the request body.

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

Response

Language

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://marketplace.walmartapis.com/v3/token \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/x-www-form-urlencoded' \
5
     --data grant_type=client_credentials \
6
     --data code=65CA5DA313A549D49D15D3119D9AD85D \
7
     --data redirect_uri=https://example-client-app.com \
8
     --data refresh_token=APXcIoTpKMH9OQN.....

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/xml

200Successful Operation