For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

Invalid access token

The OAuth access token used for your request has expired, or Paddle couldn't verify it.

Example response
{
"error": {
"type": "request_error",
"code": "invalid_access_token",
"detail": "Access token is expired or invalid.",
"documentation_url": "https://developer.paddle.com/errors/shared/invalid_access_token"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
401
Error code
invalid_access_token
Error message
Access token is expired or invalid.

Common causes

  • The access token has expired. OAuth access tokens are short-lived.
  • The access token wasn't issued by Paddle, or it was changed after it was issued.

Troubleshooting

  • Get a new access token using your refresh token or client credentials, then retry the request.
  • If you can't get a new access token, ask the user to reconnect their Paddle account to your app.

Was this page helpful?