> For the complete documentation index, see [llms.txt](https://docs.reveald.com/technical-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.reveald.com/technical-documentation/data-sources/manage-engine-patch-manager-plus/create-a-new-patch-manager-plus-api-key.md).

# Create a New Patch Manager Plus API Key

{% hint style="info" %}
API Keys need to be created to integrate Patch Manager as a data source. This guide is provided so the client can provide a re-usable refresh token. It requires the tool Postman. A basic knowledge of APIs is needed.
{% endhint %}

#### Step 1:

* Log in to Zoho API Console.
* On the **Choose a Client Type** page, select **Self Client**. This is used for integrating Python applications, which is what Epiphany uses to collect API information.

![](https://4132260347-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftkp3obVDMu3n9ZTUpfEP%2Fuploads%2FJn5fJT6HyHr7Gn2pnOKZ%2Fclip_image004.png?alt=media\&token=bf44b7ce-cde9-4105-8b54-7939242b40dc)

* On the **Create New Client** page, ensure **Self Client** is selected and then select **CREATE**.\
  \
  ![](https://4132260347-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftkp3obVDMu3n9ZTUpfEP%2Fuploads%2FgiQck0rflFtEz785bPan%2Fclip_image005.png?alt=media\&token=1d58d2e3-8138-408d-b7ae-6a964369b755)

#### Step 2:

* On the **Self Client** page, select the **Generate Code** tab and enter the following information:
  * **Scope**: Enter **PatchManagerPlusCloud.restapi.READ, PatchManagerPlusCloud.restapi.UPDATE**. This is required.
  * **Time Duration**: Select **10 Minutes**. This is required.
  * **Scope Description**: Enter **For EIP integrations to Patch Manager** or something similar. This is optional. 

![](https://4132260347-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftkp3obVDMu3n9ZTUpfEP%2Fuploads%2FANGv28CWMogz2NFEhGnj%2Fclip_image006.png?alt=media\&token=4fd9d7ca-de7b-4b0b-be9d-6893628a5610)

#### Step 3:

An API call needs to be made shortly after generating the access code. Manage Engine’s API documentation recommends using a tool like Postman to establish the call and acquire the longer-term refresh token. This generated code only lasts 10 minutes.

* On the **Generate Code** tab, select **CREATE.** A code displays that is used to make the first API call:

![](https://4132260347-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftkp3obVDMu3n9ZTUpfEP%2Fuploads%2FcB6Xvbitu4olSS24ZSgL%2Fimage.png?alt=media\&token=3f95064c-b810-49ba-9796-bf1378c78a4a)

* Select **COPY** to copy the code to your clipboard.

#### Step 4:

The initial API call will follow this format:

> <https://accounts.zoho.com/oauth/v2/token?client\\_id> =\<client\_id>\&grant\_type=authorization\_code\&client\_secret\<client\_secret>\&redirect\_uri=<http://localhost/callback\\&code=\\><code>

In Postman, the Client ID (**client\_id**) and Client Secret (**client\_secret**) are found on the **Client Secret** tab in the **Self Client** screen. A Postman setup will look something like this:

![](https://4132260347-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftkp3obVDMu3n9ZTUpfEP%2Fuploads%2FwycYRduVMRYI2E3cp9sH%2Fclip_image008.png?alt=media\&token=23572a56-e8a2-45e2-9f4b-bf2d076b7159)

#### Step 5:

You can securely store the refresh token, client ID, and client secret on the Epiphany data source portal. Instructions for doing this are in the next section, [*Add the Patch Manager Plus Credentials to Epiphany*](/technical-documentation/data-sources/manage-engine-patch-manager-plus/add-the-patch-manager-plus-credentials-to-epiphany.md).&#x20;

The refresh token is a means to re-establish API connectivity for an hour at a time using the newly generated access tokens.