> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ServiceNow

> Integrate your application with the ServiceNow API using OAuth 2.0

## 🚀 Quickstart

Connect to ServiceNow with Nango and see data flow in 2 minutes.

**1. Create the integration**

In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *ServiceNow*.

**2. Authorize ServiceNow**

Go to [Connections](https://app.nango.dev/dev/connections) -> *Add Test Connection* -> *Authorize*, enter your instance domain, then log in to ServiceNow. Later, you'll let your users do the same directly from your app.

**3. Call the ServiceNow API**

Let's make your first request to the ServiceNow Table API (fetch a list of incidents). Replace the placeholders below with your [Environment API key](https://nango.dev/docs/reference/backend/http-api/api-keys.md), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):

> [tab] cURL
>
> ```bash theme={null}
> curl "https://api.nango.dev/proxy/api/now/table/incident?sysparm_limit=5" \
>   -H "Authorization: Bearer <NANGO-API-KEY>" \
>   -H "Provider-Config-Key: <INTEGRATION-ID>" \
>   -H "Connection-Id: <CONNECTION-ID>"
> ```

> [tab] Node
>
> Install Nango's backend SDK with `npm i @nangohq/node`. Then run:
>
> ```typescript theme={null}
> import { Nango } from '@nangohq/node';
>
> const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });
>
> const res = await nango.get({
>     endpoint: '/api/now/table/incident',
>     providerConfigKey: '<INTEGRATION-ID>',
>     connectionId: '<CONNECTION-ID>',
>     params: { sysparm_limit: '5' }
> });
>
> console.log(res.data);
> ```

Or fetch credentials with the [Node SDK](https://nango.dev/docs/reference/backend/backend-sdk/node.md#get-a-connection-with-credentials) or [API](https://nango.dev/docs/reference/backend/http-api/connections/get.md).

✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.

**4. Implement Nango in your app**

Follow our [Auth implementation guide](https://nango.dev/docs/guides/auth/auth-guide.md) to integrate Nango in your app.

To obtain your own credentials, follow the setup guide linked below.

## 📚 ServiceNow Integration Guides

Nango-maintained guides for common use cases.

* [How to register your own ServiceNow OAuth app](https://nango.dev/docs/api-integrations/servicenow/how-to-register-your-own-servicenow-oauth-app)\
  Register an OAuth app with ServiceNow and obtain credentials to connect it to Nango

* [How do I link my account?](https://nango.dev/docs/api-integrations/servicenow/connect)\
  Find your instance domain and connect it to Nango

Official docs: [ServiceNow REST API Documentation](https://developer.servicenow.com/dev.do#!/reference/api/vancouver/rest/c_TableAPI)

## API gotchas

* A [ServiceNow Developer Instance](https://developer.servicenow.com/dev.do) is free for testing; production instances require a paid subscription.
* The OAuth application must be registered as **Create an OAuth API endpoint for external clients** in the Application Registry, with the redirect URL set to `https://api.nango.dev/oauth/callback`.
* Enter your instance's full domain (e.g. `your-instance.service-now.com`) in the **ServiceNow Domain** field — Nango uses it to build the authorization and token endpoints automatically.

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/api-integrations/servicenow.mdx)

## 🧩 Pre-built syncs & tools for ServiceNow

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs.

### Others

| Function name | Description | Type |
| - | - | - |
| `create-change-request` | Create a change request. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-change-task` | Create a change task under a change request. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-group` | Create a group | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident` | Create an incident | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-problem` | Create a problem | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-user` | Create a user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-change-request` | Delete a change request. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-group` | Delete a group. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-incident` | Delete an incident | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-problem` | Delete a problem | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-catalog-item` | Retrieve a service catalog item. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-catalog-request` | Retrieve a catalog request (sc\_request). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-change-request` | Retrieve a change request. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-change-task` | Retrieve a change task. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-group` | Retrieve a group. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-incident` | Retrieve an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-knowledge-article` | Retrieve a knowledge base article. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-problem` | Retrieve a problem. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-table-record` | Retrieve an allowed table record. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user` | Retrieve a user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-approvals` | List approval records (sysapproval\_approver). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-attachments` | List attachment metadata for a table record | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-catalog-items` | List service catalog items. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-catalog-request-items` | List request items (sc\_req\_item) for a catalog request. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-change-requests` | List change requests. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-change-tasks` | List change tasks. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-groups` | List sys\_user\_group records. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incidents` | List incidents. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-knowledge-articles` | List knowledge base articles. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-problems` | List problems. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-table-records` | List records from an allowed table. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-users` | List sys\_user records. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `order-catalog-item` | Order a service catalog item, creating a request and request item. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-approval` | Approve or reject a pending approval. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-change-request` | Update change request fields. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-change-task` | Update change task fields (e.g. state, work notes). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-group` | Update group fields. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-incident` | Update an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-problem` | Update problem fields | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-user` | Update user fields. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `approvals` | Sync approval records (sysapproval\_approver) | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `catalog-requests` | Sync service catalog requests (sc\_request) | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `change-requests` | Sync change requests. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `change-tasks` | Sync change tasks | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `cmdb-ci` | Sync CMDB configuration items from ServiceNow | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `groups` | Sync groups. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `incidents` | Sync incidents | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `knowledge-articles` | Sync knowledge base articles (kb\_knowledge). | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `problems` | Sync problems. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `users` | Sync users. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.