--- title: Set up the UiPath spoke description: Integrate the ServiceNow instance with your UiPath account to authenticate ServiceNow requests.Integrate the ServiceNow instance with your UiPath account using OAuth to authenticate ServiceNow requests.Integrate the ServiceNow instance with your UiPath account using API key to authenticate ServiceNow requests. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/integrate-applications/integration-hub/conf-alias-uipath.html release: australia product: Integration Hub classification: integration-hub topic_type: task last_updated: "2026-03-12" reading_time_minutes: 5 breadcrumb: [UiPath Spoke, Integration Hub spokes, Build integrations, Integration Hub, Workflow Data Fabric] --- # Set up the UiPath spoke Integrate the ServiceNow instance with your UiPath account to authenticate ServiceNow requests. ## Before you begin - Request an Integration Hub subscription. - Activate the UiPath spoke. - Role required: admin. ## About this task You can set up the UiPath spoke using OAuth authentication or API key as per your requirement. - See [Option 1: Using OAuth authentication](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/conf-alias-uipath.md) to set up the UiPath spoke using OAuth authentication. - This authentication is available from UiPath spoke v2.2.1. - You can't use MID Server if you set up the spoke using OAuth authentication. - See [Option 2: Using API key](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/conf-alias-uipath.md) to set up the UiPath spoke using API key. ## Option 1: Using OAuth authentication Integrate the ServiceNow instance with your UiPath account using OAuth to authenticate ServiceNow requests. ### Before you begin Role required: admin **Note:** - This authentication is available from UiPath spoke v2.2.1. - You can't use MID Server if you set up the spoke using OAuth authentication. ### Procedure 1. Register an application in your UiPath account. 1. Log in to your UiPath account as an admin. 2. Navigate to **Admin** > **External Applications**. 3. Click **+ Add Application**. 4. On the form, fill these values.
Field Description
Application Name Name of the OAuth application.
Application Type Type of OAuth application. Select **Confidential application**.
Resources Required resource and scopes.1. Click **+ Add Scopes**. 2. Select **Orchestrator API Access** from the **Resource** list. 3. Select these application scopes: - OR.Robots.Read - OR.Robots.Write - OR.Jobs.Read - OR.Jobs.Write - OR.Machines.Read - OR.Execution.Read - OR.Queues.Read - OR.Queues.Write - OR.Folders.Read 4. Click **Save**.
Redirect URL ServiceNow instance redirect URL in this format: `https://.service-now.com/oauth_redirect.do`
5. Click **Add**. The application is registered and values of App ID and App Secret are displayed. 6. Copy and record the values of app ID and app secret. 2. In your ServiceNow instance, configure the required connection and credential alias. 1. Log in to your ServiceNow instance as an admin. 2. Navigate to **All** > **Connections & Credentials** > **Connection & Credential Aliases**. 3. Open the record for **UiPath**. 4. For **Configuration Template**, select **UiPath Configuration Template - OAuth Client Credentials**. 5. Click the **Create New Connection & Credential** related link. 6. On the form, fill these fields. |Field|Description| |-----|-----------| |Connection information| |Name|Name to identify the OAuth application registry record.| |Connection URL|Connection URL in this format: `https://{base_url}/{organization_name}/{tenant-name}/orchestrator_`. This URL depends on the type of UiPath deployment.| |Credential information| |Name|Name to identify the credential record.| |Token URL|Location of the token endpoint that the instance uses to retrieve and refresh tokens. This URL depends on the type of UiPath deployment.| |OAuth Client ID|App ID you had copied after registering application in your UiPath account.| |OAuth Client Secret|App secret you had copied after registering application in your UiPath account.| |OAuth Redirect URL|ServiceNow instance redirect URL in this format: `https://.service-now.com/oauth_redirect.do`.| 7. Click **Create**. 8. Click **Submit**. Connection and credential records are created. 9. Open the UiPath Connection record, from the **Connections** tab. 10. Select a value for the **Orchestrator Feature Enabled** field. ### Result The Connection and Credential alias is configured and the UiPath spoke is set up using OAuth authentication. ## Option 2: Using API key Integrate the ServiceNow instance with your UiPath account using API key to authenticate ServiceNow requests. ### Before you begin Role required: admin ### Procedure 1. From your UiPath cloud account, obtain the values of the required API refresh tokens. **Note:** These steps are applicable to UiPath cloud account. 1. Log in to your UiPath account as an admin. 2. Navigate to **Preferences** > **Privacy & Security**. 3. For the required tenant, click **View API access**. The values of **User Key**, **Organization ID**, **Tenant Name**, and **Client ID** are displayed. 4. Copy and record these values. 2. In your ServiceNow instance, configure the required connection and credential alias. 1. Log in to your ServiceNow instance as an admin. 2. Navigate to **All** > **Connections & Credentials** > **Connection & Credential Aliases**. 3. Open the record for **UiPath**. 4. For **Configuration Template**, select **UiPath Configuration Template - UiPath Cloud** or **UiPath Configuration Template - Private/Public Cloud** as per your requirement. 5. Click the **Create New Connection & Credential** related link. 6. On the form, fill these fields. - If you have selected **UiPath Configuration Template - UiPath Cloud** for **Configuration Template**, fill these fields. **Note:** This option is applicable if you are using UiPath cloud account. |Field|Description| |-----|-----------| |Connection Name|Name to identify the connection record. For example, `UiPath Connection`.| |Connection URL|Connection URL in this format: `https://platform.uipath.com//`| |Credential Name|Name to identify the credential record. For example, `UiPath Credential`.| |Token URL|Location of the token endpoint that the instance uses to retrieve and refresh tokens. For example, `https://account.uipath.com/oauth/token`.| |Client Id|Value of client ID you had copied from the UiPath Orchestrator application.| |Account Logical Name|Organization ID you had copied from the UiPath Orchestrator application.| |Tenant Logical Name|Tenant name you had copied from the UiPath Orchestrator application.| |User Key|User key you had copied from the UiPath Orchestrator application.| - If you have selected **UiPath Configuration Template - Private/Public Cloud** for **Configuration Template**, fill these fields. |Field|Description| |-----|-----------| |Connection Name|Name to identify the connection record. For example, `UiPath Connection`.| |Connection URL|UiPath instance URL.| |Credential Name|Name to identify the credential record. For example, `UiPath Credential`.| |Token URL|Location of the token endpoint that the instance uses to retrieve and refresh tokens in this format: `http:///api/account/authenticate`| |Tenant Name|Tenant logical name.| |Username or email|Username or email address to authenticate the UiPath Orchestrator API.| |Password|Associated password.| **Note:** - You must enable **Use MID server** option in the connection record and create a SSL certificate from a trusted authority for on-prem support. - The MID Server users must have the sn\_uipath\_spoke.uipath\_admin role. 7. Click **Create**. 8. Click **Submit**. Connection and credential records are created. 9. Open the UiPath Connection record, from the **Connections** tab. 10. Select a value for the **Orchestrator Feature Enabled** field. ### Result The Connection and Credential alias is configured and the UiPath spoke is set up using API key.