---
schema: rendered-html/v1
title: "OAuth 2.0 Errors | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/OAuth-2.0-Errors.html
generated_at: 2026-06-11T14:43:58.488397+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- YouTrack Import Scripts
- YouTrack Form API
- YouTrack REST API
- Hub REST API
- Hub REST API Guide
- Log in to Hub
- Permanent Token Authorization in Hub
- [OAuth 2.0 Authorization in Hub](jetbrains__com__help__youtrack__devportal__oauth-authorization-in-hub.md)
- Implicit
- Authorization Code
- [Refresh Token](jetbrains__com__help__youtrack__devportal__refresh-token.md)
- [Resource Owner Password Credentials](jetbrains__com__help__youtrack__devportal__resource-owner-password-credentials.md)
- Client Credentials
- Extension Grants
- [OAuth 2.0 Errors](OAuth-2.0-Errors.html)
- REST API URL and Endpoints
- Hub OpenAPI Specification (OAS)
- Hub API Field Syntax
- Sort Syntax in Hub
- Hub API Query Syntax
- Hub REST API Reference

1. Hub REST API
2. Hub REST API Guide
3. Log in to Hub
4. [OAuth 2.0 Authorization in Hub](jetbrains__com__help__youtrack__devportal__oauth-authorization-in-hub.md)
5. [OAuth 2.0 Errors](#0)

# OAuth 2.0 Errors﻿

Last modified: 07 May 2026

## Authorization Response Error Codes﻿

| Error code | Description | Solution |
| --- | --- | --- |
| `invalid_request` | The authorization request to Hub is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed. | Check that all parameters are correct, that provided `service_id` exists, etc. |
| `unauthorized_client` | The client is not authorized to request an authorization code using this method: The `redirect_URI` of the service either is incorrect or not provided. | 1. Make sure the provided **redirectUri** is correct and properly registered as one of the service's redirect URIs. 2. Make sure your service provides at least one `redirect_uri` in Hub. |
| `unsupported_response_type` | Hub does not support obtaining an authorization code using this method. | Try to change selected method of authorization. |
| `invalid_scope` | The scope for which authorization is requested, does not match any registered service. | Make sure that request is correct. |

## Token Response Error Codes﻿

[Definition of errors of issuing Access Token in the RFC6749 standard](https://tools.ietf.org/html/rfc6749#section-5.2)

| Error code | Description | Solution |
| --- | --- | --- |
| `invalid_request` | The request is missing a required parameter, includes an unsupported parameter value (other than grant type), repeats a parameter, includes multiple credentials, utilizes more than one mechanism for authenticating the client, or is otherwise malformed.  Possible reasons: Authorization header in response is not of the Bearer type. Also, a parameter in the token request may be mulformed or missing. | Please check the response header. Then check if the request is correct. |
| `invalid_client` | Client authentication failed. For example, the client is unknown, no client authentication included, or authentication method is unsupported.  Possible reasons:   - No service with the provided `clientServiceId` was found. - Authorization header was either of invalid format or not passed at all. |  |
| `invalid_grant` | Possible reasons:   - Refresh token was issued to another client service. - Refresh token is unknown. - Authorization code is unknown or is of invalid format. - The service secret is of invalid format. - Provided credentials of the service owner are invalid. - Requested scope does not match allowed by access token |  |
| `unauthorized_client` | Possible reasons: The service that requests authorization token is not verified. |  |
| `unsupported_grant_type` | Possible reasons: The authorization grant type is not supported by Hub. |  |
| `invalid_scope` | Possible reasons: The scope to which you are requiring access token does not match any registered service. | Please check the request. |

- [OAuth 2.0 Errors](/help/youtrack/devportal/OAuth-2.0-Errors.html)
- [Authorization Response Error Codes](/help/youtrack/devportal/OAuth-2.0-Errors.html#AuthorizationResponseErrors)
- [Token Response Error Codes](/help/youtrack/devportal/OAuth-2.0-Errors.html#-xe8jxp_4)

Extension GrantsREST API URL and OAuth 2.0 Endpoints

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.
