# OAuth2 Client Credentials

<mark style="color:green;">SINCE VERSION 8.1.0</mark>

Email This Issue now supports OAuth2 authorization protocol to access email services such as Gmail.

OAuth2 specifications define the concept of Client Credentials which is comprised of two attributes: Client ID and Client Secret.

To obtain such a credential, you must visit your email service provider’s console page and have your provider generate a Client ID-Secret pair for you. See how you can do this with Google or Microsoft.&#x20;

* [Gmail with OAuth2](/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/administration/mail-server-connections/gmail-with-oauth2.md)
* [Microsoft with OAuth2](/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/administration/mail-server-connections/microsoft-with-oauth2.md)

Once you generated a Client ID-Secret pair with your service provider, you must save these credentials in Email This Issue and use them in [Incoming Mail Accounts](/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/administration/incoming-mail-connections.md) and [Outgoing Mail Connections](/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/administration/outgoing-mail-connections.md) if you choose to use OAuth2 authorizations to access these services.

Client credentials (client ID and Secret) are required to access the provider and retrieve the so called Refresh Tokens and Access Tokens that ensure you’re allowed to access the service.

Without such credentials, OAuth2 authorization will not work.

### OAuth2 Credentials in Email This Issue <a href="#oauth2clientcredentials-oauth2credentialsinemailthisissue" id="oauth2clientcredentials-oauth2credentialsinemailthisissue"></a>

To find the saved credentials or create new ones go to **SETTINGS** --> **OAuth2 Client Credentials**.

![](/files/bfMZm0MWOkHxDcc7qbNN)

### Adding a new credential <a href="#oauth2clientcredentials-addanewcredential" id="oauth2clientcredentials-addanewcredential"></a>

|                        | Description                                                                                                                                                       |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                   | Name your credentials so that you can recognize them later                                                                                                        |
| Service Provider       | The email service provider like Google OAuth2 Provider                                                                                                            |
| Client ID              | Enter the Client ID obtained from your service provider                                                                                                           |
| Client Secret          | Enter the Client Secret obtained from your Service Provider completing the Client ID                                                                              |
| Authorization Endpoint | <p>Service Provider’s authorization service</p><p>Google: <a href="https://accounts.google.com/o/oauth2/auth"><https://accounts.google.com/o/oauth2/auth></a></p> |
| Token Endpoint         | <p>Service Provider’s token service</p><p>Google: <a href="https://oauth2.googleapis.com/token"><https://oauth2.googleapis.com/token></a></p>                     |
| Callback URL           | <p>The URL to which the Service Provider will redirect during the authorization process.</p><p>This is relative to your Jira instance.</p>                        |

{% hint style="info" %}
**Note**: Client Secret is stored in an encrypted form in the database.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/administration/oauth2-client-credentials.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.