# Connection

> The **Connection** dialog uses the [UiPath Orchestrator API](https://docs.uipath.com/orchestrator/automation-cloud/latest/api-guide/read-me) to create a connection to a specific orchestrator tenant.

The **Connection** dialog uses the [UiPath Orchestrator API](https://docs.uipath.com/orchestrator/automation-cloud/latest/api-guide/read-me) to create a connection to a specific orchestrator tenant.

Once a **Connection** has been established it can be used by **Actions** in recipes.

## How it works

1. Go to Workato **App Connections** tab and click **Create Connection**.

   ![Workato App Connections tab with Create Connection button](https://dev-assets.cms.uipath.com/assets/images/add-ins/add-ins-docs-image-45053-ba1cc0f0-f2ecc451.webp)
2. Search for UiPath add-in and click on it.

   ![UiPath add-in search result in Workato](https://dev-assets.cms.uipath.com/assets/images/add-ins/add-ins-docs-image-44805-9867c86a-e678827f.webp)
3. Fill in your Orchestrator connection details.
4. Depending on the options you choose, you have to provide different connectivity parameters.

   ![Orchestrator connection details form in Workato](https://dev-assets.cms.uipath.com/assets/images/add-ins/add-ins-docs-image-44685-12750f08-13fdb81f.webp)

Here is an example of a successful connection to a Cloud Orchestrator.

You need an API access token in order to connect successfully to your Orchestrator. You can find details on how to get this in the Automation Cloud [documentation](https://docs.uipath.com/automation-cloud/automation-cloud/latest/api-guide/api-keys).

![Successful Cloud Orchestrator connection in Workato](https://dev-assets.cms.uipath.com/assets/images/add-ins/add-ins-docs-image-44476-10684ea6-a357b435.webp)

You can use this connection now with UiPath actions in all your recipes. The add-in handles session tokens and other required details, such as folder and organization IDs, in subsequent API calls to your Orchestrator API.

## Properties

| Property | Description |
| --- | --- |
| **Connection Name** | The name of your connection. You can reuse it in other recipes. This field supports only `String` variables. |
| **Connection Type** | Indicate if the connection is in an on-premise Orchestrator or Automation Cloud. |

### On-premise connection properties

| Property | Description |
| --- | --- |
| **UiPath Orchestrator URL** | The URL of your Orchestrator tenant. This field supports only `String` variables. |
| **Orchestrator Tenant Name** | The name of your Orchestrator tenant. This field supports only `String` variables. |
| **Email or Username** | Your email or username. This field supports only `String` variables. |
| **Password** | The password for the email or username specified above. This field supports only `String` variables. |
| **Folder** | The folder to use. This can be a classic or a modern folder name. This field supports only `String` variables. If a folder is not specified, the connection presumes the default Classic folder for this Orchestrator tenant. |

### Cloud connection properties

| Property | Description |
| --- | --- |
| **Account Logical Name** | The account logical name. This field supports only `String` variables. |
| **Tenant Logical Name** | The tenant logical name. This field supports only `String` variables. |
| **Client ID** | The client ID for this connection. This field supports only `String` variables. |
| **User Key** | The user key for this connection. This field supports only `String` variables. |
| **Folder** | The folder to use. This can be a classic or a modern folder name. This field supports only `String` variables. If a folder is not specified, the connection will presume the default Classic folder for this Orchestrator tenant. |