---
updatedAt: 2026-07-27T16:08:05.000Z
---

# Create EPCIS access token

This request creates an access token. The Walmart 1P Supplier APIs use <a href="https://oauth.net/2/" target="_blank"> OAuth 2.0</a> bearer tokens for token-based authentication.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "EPCIS",
    "description": "Use the Walmart EPCIS APIs to integrate with Walmart's EPCIS traceability services.",
    "version": "v1",
    "contact": {
      "name": "Blockchain Platform Team",
      "email": "Blockchain_US@wal-mart.com"
    }
  },
  "servers": [
    {
      "url": "https://developer.api.stg.walmart.com/api-proxy/service/identity/oauth",
      "description": "OAuth Token"
    },
    {
      "url": "https://developer.api.us.stg.walmart.com/api-proxy/service/concorde/hub/v1",
      "description": "EPCIS Event and Validation APIs"
    }
  ],
  "tags": [
    {
      "name": "EPCIS Authorization",
      "description": "Use this endpoint to create access tokens to ensure that your users are verified.\nThe Walmart 1P Supplier APIs use <a href=\"https://oauth.net/2/\" target=\"_blank\"> OAuth 2.0</a> bearer tokens for token-based authentication."
    }
  ],
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false,
    "explorer-enabled": true
  },
  "paths": {
    "/v1/token": {
      "post": {
        "tags": [
          "EPCIS Authorization"
        ],
        "summary": "Create EPCIS access token",
        "description": "This request creates an access token.\nThe Walmart 1P Supplier APIs use <a href=\"https://oauth.net/2/\" target=\"_blank\"> OAuth 2.0</a> bearer tokens for token-based authentication.",
        "operationId": "generateOAuthToken",
        "parameters": [
          {
            "name": "wm_consumer.id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Your Walmart-provided consumer identifier."
          },
          {
            "name": "content-type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "application/x-www-form-urlencoded"
            },
            "description": "Specifies the `application/x-www-form-urlencoded` content type."
          }
        ],
        "requestBody": {
          "description": "OAuth Request",
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/OAuthFormData"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthTokenResponse"
                },
                "examples": {
                  "success": {
                    "summary": "A successful response returns an access token, token type, and expiration time.",
                    "value": {
                      "access_token": "eyJraWQiOiIzZj…VhYTFmNS1hYWE5LTQzM",
                      "token_type": "Bearer",
                      "expires_in": 900
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "OAuthFormData": {
        "type": "object",
        "required": [
          "client_id",
          "client_secret",
          "grant_type"
        ],
        "properties": {
          "grant_type": {
            "type": "string",
            "description": "Specifies the OAuth 2.0 `client_credentials` grant type.\n\nValid value: `client_credentials`.",
            "example": "client_credentials"
          },
          "client_id": {
            "type": "string",
            "description": "Your Walmart-provided client identifier.",
            "example": "my_client_id"
          },
          "client_secret": {
            "type": "string",
            "description": "Your Walmart-provided client secret.",
            "example": "my_client_secret"
          }
        }
      },
      "OAuthTokenResponse": {
        "type": "object",
        "required": [
          "access_token",
          "expires_in",
          "token_type"
        ],
        "properties": {
          "access_token": {
            "type": "string",
            "description": "Your API request access token.",
            "example": "eyJraWQiOiIzZj…VhYTFmNS1hYWE5LTQzM"
          },
          "token_type": {
            "type": "string",
            "description": "Indicates the type of access token.\n\nValid value:`Bearer`.",
            "example": "Bearer"
          },
          "expires_in": {
            "type": "integer",
            "format": "int32",
            "description": "Number of seconds until the access token expires.",
            "example": 900
          }
        }
      }
    }
  }
}
```