UiPath Documentation
integration-service
2.2510
true

Integration Service user guide

Last updated May 11, 2026

ServiceNow authentication

UiPath supports the following authentication types for ServiceNow:

Authentication typeDescriptionBest for
Basic (username/password)Direct login with a ServiceNow user over HTTPS Basic authentication.Simple, non-OAuth setups, perfect for quick POCs
OAuth 2.0 Password GrantService account username/password plus OAuth client credentials exchanged for tokens.Service-to-service integrations where OAuth is required but interactive login is not practical.

Basic (username/password)​

Connection fields​

FieldDescription
Site URLFull ServiceNow instance URL, for example https://your-instance.service-now.com.​
UsernameServiceNow integration user name.​
PasswordPassword for the integration user.​

Common issues​

4XX errors

  • Verify Instance URL, Username, and Password; ensure the account is active and not locked or blocked by IP/login policies.​
  • Check that the user can read sys_db_object , sys_dictionary and has the necessary ACLs on target tables (read/insert/update/delete).
  • Make sure your ServiceNow instance is not hibernating.

OAuth 2.0 Password​

Connection fields​

FieldDescription
Site URLFull ServiceNow instance URL.
UsernameServiceNow service account username.
PasswordPassword for that service account.
Client IDClient ID from the ServiceNow OAuth client.​
Client SecretClient Secret from the same OAuth client.​

Set up OAuth​

Note:

The following procedure applies to Washington, Yokohama, and earlier versions of ServiceNow. If you are on Zurich or Australia, see Set up OAuth for Zurich and Australia (Inbound Integration).

Complete the Set up OAuth steps in the ServiceNow documentation.

While the documented steps are likely the same across all ServiceNow platform regions, it's recommended that you follow the steps for your specific region in case there are differences.

For reference, the following procedure explains how we setup OAuth for our examples.

  1. Sign in to your ServiceNow instance (e.g., https://<span>dev74293.service-now.com/login</span>)
  2. Go to System Definitions > Plugins and verify the OAuth plug-in Status is set to Active.

  1. Go to System OAuth > Application Registry and select New.
    • When asked What kind of OAuth application?, select Create an OAuth API endpoint for external clients.

  1. Enter a Name for your application (e.g. UiPathQuickstart) and select Submit (if successful, you're redirected back to your Application Registries list).

  1. In the Application Registries list, find your new application and select the Name to open the details page.
  2. Select on the lock icon next to Client Secret to show the value.
  3. Take note of the Client Id and Client Secret values.
  4. Type the following redirect URL in its corresponding field: https://{yourDomain}/provisioning_/callback.

Set up OAuth for Zurich and Australia (Inbound Integration)​

For Zurich, Australia, and later versions, ServiceNow has replaced the Create OAuth API endpoint for external clients option with a simplified Inbound Integration flow configured through the Machine Identity Console.

Follow the Configure an OAuth Authorization Code Grant steps in the ServiceNow documentation to create an Inbound Integration.

When configuring the Inbound Integration, set the redirect (callback) URL to: https://{yourDomain}/provisioning_/callback.

Note:
  • Uncheck Allow access only to APIs in selected scope if you want users' access controls and API policies to apply by default.
  • If you enable Allow access only to APIs in selected scope and assign scopes, the Tables API scope is required for the integration to work.
Note:

The Zurich/Australia Inbound Integration procedure is documented for the OAuth Authorization Code grant flow. If you are using OAuth 2.0 Password grant, check the ServiceNow documentation to confirm whether the same Inbound Integration setup also covers the Password grant client configuration in your ServiceNow version.

Add the ServiceNow connection​

To create a connection to your ServiceNow instance, you need to perform the following steps:

  1. Select Integration Service from the left rail.
  2. From the Connectors list, select ServiceNow. You can also use the search bar to narrow down the connector.
  3. Select the Connect to ServiceNow button.
  4. Select your preferred authentication type and enter the required credentials.
  5. Select Connect.
  6. Next, enter your ServiceNow username and password. The app asks for your permission to connect to your ServiceNow account and to interact with records. Select Allow.

For more information on creating connections with ServiceNow, refer to ServiceNow Product Documentation.

ServiceNow roles and permissions​

The following table lists the minimum roles and permissions required for creating a connection and using the ServiceNow connector. The requirements apply to all authentication types.

ServiceNow TableOperationAccess reason
Tables (sys_db_object)readThe Tables module/table functions as a repository that holds a row corresponding to each table in your ServiceNow instance. It is utilized to compile a list of tables for the purpose of executing actions or triggering events. This is required to load all your tables when you using the Select Object dropdown for you CRUD activities.
Dictionary (sys_dictionary)readThis table encompasses data about respective columns of a particular table within your ServiceNow instance. This table is required to load input and output fields when you select a table for carrying out an action.
Choices (sys_choice)readThe Choice table contains values for options that appear in choice lists and also for look ups in our curated activities. Without this the design time look ups in our activities will fail to load.
User (sys_user)readThe Choice table contains translated text for options that appear in choice lists and also for look ups in our curated activities. Without this the design time user related look ups in our activities will fail to load.

Furthermore, the user must also possess the requisite access control for the tables essential to the integration scenario. For instance, if you intend to establish an integration user capable of executing typical ITIL help desk actions (e.g., opening, updating, and closing incidents, problems, changes, and configuration management items), you should assign the itil role.

Creating custom roles​

Certain Base system roles, such as admin already encompass access control for these tables. But, if you don't want to assign base system roles and aim to provide only the essential access control required for using the ServiceNow connector, you may consider crafting a custom role with the necessary access permissions.

To grant access exclusively to specific tables or tables not covered by the default base system roles, we recommend the creation of custom roles and the assignment of the appropriate access control as needed.

You must provide the new roles with the access controls listed in the following table in order to utilize the ServiceNow connector/activities. For example, a user without administrator permissions requires the personalize_dictionary role to access the sys_dictionary table.

TableTypeOperation
Tables (sys_db_object)recordread
Dictionary (sys_dictionary)recordread
Choices (sys_choice)recordread
User (sys_user)recordread
Field classes (sys_glide_object)recordread
Note:

Editing or creating access control is a capability exclusive to a user possessing the security\_admin role. If you have any uncertainties, it is advisable to consult your ServiceNow administrator. You can find additional information in elevated privilege roles.

For carrying out activity or trigger executions, you need to provide other access controls as well.

For instance, if your specific scenario involves initiating a workflow with a ServiceNow incident or creating a ServiceNow incident, the following access controls need to be granted.

TableTypeOperation
Incidentrecordread
Incidentrecordwrite

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated