# ServiceNow (prebuilt connector)

## Description

**ServiceNow** is a cloud-based workflow automation and IT Service Management (ITSM) platform that helps organisations streamline and automate processes across IT, HR, facilities, customer service, and more.

## API documentation

API documentation for ServiceNow (used to build this connector) can be found via the link below:

{% embed url="<https://www.servicenow.com/docs/bundle/yokohama-api-reference/page/build/applications/concept/api-rest.html>" %}

## Authentication&#x20;

When adding connector instances for ServiceNow, the following authentication methods are supported:

* [ServiceNow auth](#servicenow-auth)

### ServiceNow auth

When a user chooses to [add a connector instance](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance) using `ServiceNow Auth` authentication, the credentials below are prompted:

<table><thead><tr><th width="247.9609375">Credential</th><th width="117.62109375" data-type="checkbox">Required?</th><th>Notes</th></tr></thead><tbody><tr><td><code>Scope</code></td><td>true</td><td>Determines what access or permissions are granted to Patchworks. You can define custom scopes in the ServiceNow dashboard. </td></tr><tr><td><code>Grant type</code></td><td>true</td><td>Set to <code>client_credentials</code>.</td></tr><tr><td><code>Client ID</code></td><td>true</td><td>A unique id generated when a new OAuth application is created in ServiceNow.</td></tr><tr><td><code>Client secret</code></td><td>true</td><td>The secret associated with the client id, generated when a new OAuth application is created in ServiceNow.</td></tr><tr><td><code>Response authentication token key</code></td><td>true</td><td>Set to <code>access_token.</code></td></tr><tr><td><code>Username</code> / <code>password</code></td><td>true</td><td>Credentials for the ServiceNow user account to be authenticated.</td></tr></tbody></table>