---
title: "Set Up Integration Hub"
canonical: "https://help.agiloft.com/space/HELP/597688481/Set+Up+Integration+Hub"
format: markdown
---
Follow the steps in this article to complete the initial setup of the Integration Hub. When you deploy the hub, the system automatically installs and configures the Agiloft connector in your workspace and creates an OAuth 2.0 client application in your KB for secure authentication between the hub and your system.

> ℹ️ **Prerequisites**
> ℹ️ 
> ℹ️ Purchasing the Integration Hub add-on includes one admin user license for the Agiloft CLM connector. Make sure a separate integration user account with an admin license is created in your KB. This account functions as a dedicated service user for connector authentication and access token management. Since the system auto generates the OAuth client and connector during the setup, you’ll need to log in to your KB as the integration service user when you deploy the Integration Hub. For information on creating users, see [User Management](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/926744591).

> 📝 If you have an existing Workato environment and were instructed to connect it to your KB without the Integration Hub, see [Optional: Connect an existing Workato environment](#connect_workato) below.

To set up the Integration Hub: 

1. Log in to your KB as the integration user and go to **Setup > Integration**.
2. Locate OAuth2 Client Setup. If you see Deploy, click it and then click OK. Wait until the deployment is complete. If you see Configure, go to the next step.
3. Now locate Webhooks. If you see Deploy, click it and then click OK. Wait until the deployment is complete. If you see Configure, go to the next step.
4. Now go to **Setup > Integration Hub**. Wait a few seconds while the system creates the workspace and default folder structure, imports the Agiloft connector, and creates an OAuth 2.0 client.
5. Once you’re in the Integration Hub, go to the App Connections tab.
6. Click the Agiloft OAuth 2.0 Connection. The fields are all completed automatically.
7. Scroll to the bottom and click Connect.
8. When prompted to authenticate, log in with the integration user credentials.
9. Finally, go to **Setup > System > Security**. If the Trusted Zones field includes a list of addresses, add `*workato.com` to the list to permit your KB to communicate with Workato. Then click Finish.

Now that the hub and connector are set up, you can start integrating with applications. See [Designing Integration Hub Recipes](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/597655630).

### > Macro (anchor)

Optional: Connect an existing Workato environment

If you have a pre-existing Workato environment and were instructed to connect it to your KB instead of performing the usual setup described above, you can use the private Agiloft connector in Workato. The process involves installing the connector, creating an OAuth 2.0 client application, and configuring the connector to use the OAuth client for secure authentication between Workato and your system.

Follow the steps below to get the connector and connect Workato to your KB.

1. First deploy the connector in Workato:
  1. In Workato, go to the Community Library and click the Custom connectors tab.
  2. Search for Agiloft and click Agiloft in the results.
  3. Click Install then Accept and install.
  4. When you’re prompted to release the connector, click Release connector. You can edit the change summary if needed, then click Release to finish the deployment.
2. Next, create an OAuth 2.0 client application in your KB:
  1. Log in to your KB as an administrator.
  2. Go to **Setup > Integration > OAuth2 Client Setup**.
  3. Click New to create a client.
  4. In the client configuration, leave Authorization Code selected as the Authorization Grant Type.
  5. Next, give the client a Name and Display Name. Name is the name the application uses with the REST API, and Display Name is the name that appears in the KB.
  6. In the Full Name field, select the integration user account. Selecting the user automatically populates the Associate this Application with Contact ID field with the user ID.
  7. In the Redirect URI field, add this URI: `https://www.workato.com/oauth/callback`
  8. Set the Token Expiry in Minutes field to the number of minutes the access token should remain valid before expiring. The default value is 15. Valid values are 1 to 60.
  9. Now, click Save to save the configuration.
  10. Scroll to the bottom of the screen and click Enable. The system generates a Client ID and Client Secret for the application.
  11. Copy the Contact ID, Client ID, and Client Secret values to an accessible location where you can access them in the next step.
3. Now, create the connection in Workato:
  1. In Workato, go to Projects, then go to Connections.
  2. Click Create and select Connection.
  3. Search for Agiloft and click the Agiloft connector in the results. The Connect to Agiloft screen is displayed.
  4. Give the connection a Name.
  5. In the Location field, select the project where you want to store the connection.
  6. In Connection Type, leave Cloud selected.
  7. Under Subdomain, click Define subdomain and select Use custom URL. Then enter the base URL for your KB. For example: `https://example.agiloft.com`
  8. In Knowledgebase, enter your KB name.
  9. Add the Contact ID, Client ID, and Client Secret values that you copied from the OAuth client configuration.
  10. Select the Language if needed and then click Connect. You are prompted to authenticate the connection.
  11. Supply the credentials for the integration service account user and click OK, then click Allow Access. The connection is established.

Now that the Agiloft CLM connector is connected to your KB, you can use the connector in your integration recipes.

#### Related articles

> Macro (contentbylabel)