Skip to content

unauthorized โ€‹

unauthorized

Description โ€‹

The request is missing valid authentication credentials.

HTTP Status โ€‹

401 Unauthorized

doc_url Format โ€‹

The doc_url value is an absolute URL and changes by environment:

<docs-base-url>/errors/unauthorized

Typical Causes โ€‹

  • Missing Authorization header.
  • Invalid or expired bearer token.
  • Signature verification failed for webhook requests.

Example โ€‹

Response:

json
{
  "errors": [
    {
      "code": "unauthorized",
      "message": "Invalid webhook signature",
      "doc_url": "https://docs.example.com/errors/unauthorized"
    }
  ]
}

How To Fix โ€‹

  1. Provide a valid authentication token or signature.
  2. Verify token format, signing secret, and environment configuration.
  3. Retry with corrected authentication credentials.