Skip to content
ajan.io

Docs menu

On this page

ServiceNow

Connect ServiceNow to ajan 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 ajan to create and manage incidents, search tasks, look up users and groups, and query configuration items directly from your conversations.

Prerequisites

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

Setup

Register an OAuth application in ServiceNow

Follow ServiceNow's OAuth setup guide to register an OAuth API endpoint for external clients. Fill in the name and redirect URL provided by ajan, then save. Note the Client ID and Client Secret.

Go to Integrations and find ServiceNow in the list.

Enter your instance details

Enter the Client ID and Client Secret for your OAuth app. Members enter the ServiceNow instance URL when they connect, for example https://acme.service-now.com, unless you set a default under OAuth connection details.

Authorize via OAuth

Click Connect to complete the OAuth flow and authorize ajan to access your ServiceNow instance.

Start using ServiceNow in ajan

Tag the integration with @ in any agent to start working with your ServiceNow data.

Common Use Cases

  • Incident Management β€” Create, update, and retrieve incidents; add comments and work notes
  • Task Tracking β€” Find and manage tasks and service catalog items across your instance
  • Configuration Management β€” Search and browse configuration items and their dependencies in the CMDB
  • User & Group Lookup β€” Find users and groups to assign incidents or retrieve contact information

Troubleshooting

IssueSolution
OAuth app not foundVerify the OAuth application is correctly registered in System OAuth β†’ Application Registry
Authorization failedCheck the Client ID and Secret match the values in your ServiceNow OAuth app
Instance not reachableConfirm your ServiceNow instance URL format: https://[instance].service-now.com
Permission deniedEnsure the authenticated user has the required roles (e.g. itil for incident management)