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

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) or ca (Canada)

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