> For the complete documentation index, see [llms.txt](https://docs.aicrisk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aicrisk.com/admin/custom-apis/oauth2-api.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.