---
updatedAt: 2026-09-02T08:42:20.000Z
agentTools:
  projectIndex: https://developer.weedmaps.com/llms.txt
---

# Retrieve Access Token

After a listing has added you as their integrator, you can request an access token using your client credentials.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Auth API",
    "description": "Weedmaps offers a suite of API solutions designed to help integration partners solve real business problems across the cannabis industry.\n",
    "termsOfService": "https://weedmaps.com/legal/developer-terms",
    "contact": {
      "name": "Contact Us: Weedmaps",
      "url": "https://developer.weedmaps.com/v2025.07/docs/contact-us"
    },
    "version": "2025-07"
  },
  "servers": [
    {
      "url": "https://api-g.weedmaps.com/auth"
    }
  ],
  "tags": [
    {
      "name": "Authorization",
      "description": "Following OAuth2 ClientCredentials Flow to receive an Access Token.",
      "externalDocs": {
        "url": "https://developer.weedmaps.com/docs/obtaining-an-access-token",
        "description": "Weedmaps Authorization Guide"
      }
    }
  ],
  "externalDocs": {
    "description": "Visit our Menu API Guides to Learn More about how you can integrate with Weedmaps.",
    "url": "https://developer.weedmaps.com/v2025.07/docs/wm-menu-api-getting-started"
  },
  "paths": {
    "/token": {
      "post": {
        "tags": [
          "Authorization"
        ],
        "summary": "Retrieve Access Token",
        "description": "After a listing has added you as their integrator, you can request an access token using your client credentials.",
        "operationId": "POST_client_credentials",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "client_id",
                  "client_secret",
                  "grant_type"
                ],
                "properties": {
                  "client_id": {
                    "type": "string",
                    "description": "OAuth client Identifier",
                    "example": "CLIENT_ID_HERE"
                  },
                  "client_secret": {
                    "type": "string",
                    "description": "OAuth client secret",
                    "example": "CLIENT_SECRET_HERE"
                  },
                  "grant_type": {
                    "type": "string",
                    "enum": [
                      "client_credentials"
                    ],
                    "description": "OAuth grant type",
                    "example": "client_credentials"
                  },
                  "scope": {
                    "type": "string",
                    "description": "Space-separated list of OAuth scopes",
                    "example": "taxonomy:read brands:read products:read products:reviews:read menu_items menus:write"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Token Retrieval",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "access_token": {
                      "type": "string",
                      "description": "The access token"
                    },
                    "token_type": {
                      "type": "string",
                      "example": "Bearer"
                    },
                    "expires_in": {
                      "type": "integer",
                      "description": "Expiration time in seconds"
                    },
                    "scope": {
                      "type": "string",
                      "example": "taxonomy:read brands:read products:read products:reviews:read menu_items menus:write"
                    },
                    "created_at": {
                      "type": "integer",
                      "description": "Creation time in seconds",
                      "example": 1753304453
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Not Found (Check your Credentials)"
          },
          "403": {
            "$ref": "#/components/responses/403"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Errors_Forbidden": {
        "properties": {
          "detail": {
            "example": "Confirm that you are requesting all necessary scopes during token creation, and that the Listing has granted you access.",
            "type": "string"
          },
          "meta": {
            "description": "Non-standard meta information about this error.",
            "properties": {},
            "type": "object"
          },
          "status": {
            "example": 403,
            "format": "int32",
            "type": "integer"
          },
          "title": {
            "example": "Forbidden",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "responses": {
      "403": {
        "description": "Forbidden",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Errors_Forbidden"
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```