# 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](/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance.md) 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/servicenow-prebuilt-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.