# OAuth2 API

### Setup <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d"></a>

In order to setup OAuth2 connections to third party APIs you will need to have the following values entered into your key value.

1. ### Oauth2--\[API-NAME]--ClientID <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e20815e" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e20815e"></a>
2. ### Oauth2--\[API-NAME]--ClientSecret <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e208170" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e208170"></a>
3. ### Oauth2--\[API-NAME]--TokenURL <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d"></a>
4. ### Oauth2--\[API-NAME]--Scopes <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d"></a>
5. ### Oauth2--\[API-NAME]--RefreshTokenURL <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d"></a>
6. ### Oauth2--\[API-NAME]--AuthURL <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e20814d"></a>

## EXAMPLE ZOOM Transcripts:

To create an oauth connection to zoom you will first need to create a new Zoom application with access to the correct scopes by going to <https://marketplace.zoom.us/> and create a new application.&#x20;

For this example the API Name will be Zoom and therefore your redirect url will use the following callback https\://\[Your AI RIsk Domain]/callback/Zoom

{% hint style="info" %}
Note that the callback will allways use the format of callback/API Name

The api name is also the prefix in the configuration of your secrets
{% endhint %}

### Add the following secrets to your key store on azure <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e2081e6" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e2081e6"></a>

### Oauth2--Zoom--AuthURL = <https://account.box.com/api/oauth2/authorize> <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e2081e6" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e2081e6"></a>

### Oauth2--Zoom--ClientID = \[Your Client ID] <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e2081f6" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e2081f6"></a>

### Oauth2--Zoom--ClientSecret = \[Your Client Secret] <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e208208" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e208208"></a>

### Oauth2--Zoom--Scopes = cloud\_recording:read:list\_user\_recordings cloud\_recording:read:list\_user\_recordings:admin <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e20821a" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e20821a"></a>

### Oauth2--Zoom--TokenURL = <https://zoom.us/oauth/token> <a href="#id-74ad9204-5f2a-47bf-bb6e-af9d1e20825e" id="id-74ad9204-5f2a-47bf-bb6e-af9d1e20825e"></a>


---

# 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.aicrisk.com/admin/custom-apis/oauth2-api.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.