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

# ServiceNow

> Connect ServiceNow to Langdock to manage incidents, tasks, and configuration items from your conversations

## Overview

ServiceNow is an IT service management platform for operations automation and workflow orchestration. Once connected, you can use Langdock to create and manage incidents, search tasks, look up users and groups, and query configuration items directly from your conversations.

<Info>
  **Authentication:** OAuth
  **Category:** IT Service Management
  **Availability:** All workspace plans
</Info>

## Prerequisites

* A ServiceNow instance with admin access
* An OAuth application registered on your ServiceNow instance (required before connecting)

## Setup

<Steps>
  <Step title="Register an OAuth application in ServiceNow">
    Follow [ServiceNow's OAuth setup guide](https://docs.servicenow.com/bundle/xanadu-platform-security/page/administer/security/task/t_CreateEndpointforExternalClients.html) to register an OAuth API endpoint for external clients. Fill in the name and redirect URL provided by Langdock, then save. Note the **Client ID** and **Client Secret**.
  </Step>

  <Step title="Navigate to Integrations in Langdock">
    Go to [Integrations](https://app.langdock.com/integrations) and find **ServiceNow** in the list.
  </Step>

  <Step title="Enter your instance details">
    Enter your ServiceNow instance URL (e.g. `https://your-instance.service-now.com`), Client ID, and Client Secret.
  </Step>

  <Step title="Authorize via OAuth">
    Click **Connect** to complete the OAuth flow and authorize Langdock to access your ServiceNow instance.
  </Step>

  <Step title="Start using ServiceNow in Langdock">
    Tag the integration with `@` in any agent to start working with your ServiceNow data.
  </Step>
</Steps>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Incident Management" icon="triangle-exclamation">
    Create, update, and retrieve incidents; add comments and work notes
  </Card>

  <Card title="Task Tracking" icon="list-check">
    Find and manage tasks and service catalog items across your instance
  </Card>

  <Card title="Configuration Management" icon="server">
    Search and browse configuration items and their dependencies in the CMDB
  </Card>

  <Card title="User & Group Lookup" icon="users">
    Find users and groups to assign incidents or retrieve contact information
  </Card>
</CardGroup>

## Troubleshooting

| Issue                      | Solution                                                                                    |
| -------------------------- | ------------------------------------------------------------------------------------------- |
| **OAuth app not found**    | Verify the OAuth application is correctly registered in System OAuth → Application Registry |
| **Authorization failed**   | Check the Client ID and Secret match the values in your ServiceNow OAuth app                |
| **Instance not reachable** | Confirm your ServiceNow instance URL format: `https://[instance].service-now.com`           |
| **Permission denied**      | Ensure the authenticated user has the required roles (e.g. `itil` for incident management)  |