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

# ServiceNow ITSM

> Instructions to authenticate with ServiceNow ITSM API

## Supported Data Models

* [ITSM Ticket](/integrations/itsm#supported-fields-for-itsm-ticket)
* [ITSM Comment](/integrations/itsm#supported-fields-for-itsm-comment)
* [ITSM Attachment](/integrations/itsm#supported-fields-for-itsm-attachment)
* [ITSM User](/integrations/itsm#supported-fields-for-itsm-user)
* [ITSM Group](/integrations/itsm#supported-fields-for-itsm-group)

## Required Parameters

These parameters are mandatory for the connector to authenticate and function properly.

| Variable        | Description                                                                                                                                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Instance Name` | Your ServiceNow instance name(if the instance url is [https://devxxxxxx.service-now.com](https://devxxxxxx.service-now.com) -  put the instance name as devxxxxxx) |
| `Username`      | Your ServiceNow username                                                                                                                                           |
| `Password`      | Your ServiceNow password                                                                                                                                           |

# Creating a ServiceNow User for Leen Integration

This guide walks you through creating a ServiceNow user and assigning the appropriate roles to enable Leen to connect and interact with your ServiceNow instance.

## Create a User

1. Login to ServiceNow portal using admin privilges.
2. Navigate to **All > User Administration > Users**
3. Select **New**
4. Fill in the mandatory fields on the form:
   * **User ID** - This will be used as the username in the Leen connection
   * Complete all other required fields and save the record
5. Set up the user's password:
   * After saving, select **Set Password**
   * Create a password that can be permanent or temporary
   * Copy this password for use in the Leen connection configuration

**📝 Password Configuration Notes:**

* If you check `Password needs reset`, the user will be required to change the password during first login
* For API-only access where the user doesn't need ServiceNow UI access, you can set appropriate restrictions

## Assign Roles

1. Navigate to **All > User Administration > Users**
2. Open the previously created user record
3. Scroll down to the **Roles** related list
4. Click **Edit**
5. Assign following roles by dragging them from the left bucket to the right:

### Role Options

| Role              | Description                                                      |
| ----------------- | ---------------------------------------------------------------- |
| `itil`            | Provides access to incident, problem, and change management data |
| `sn_request_read` | Provides read access to service catalog requests                 |

6. Select **Save** to apply the role assignments

***

## Additional Configuration (Optional)

### Table Access

By default, the `itil` role provides access to core ITSM tables including:

* Incidents (incident)
* Problems (problem)
* Changes (change\_request)
* Service Requests (sc\_request)
* Tasks (task)

If your organization uses custom ITSM tables or has additional security restrictions, you may need to grant the integration user additional read permissions to those specific tables.

### API Rate Limits

ServiceNow enforces API rate limits based on your subscription tier. Ensure your instance has sufficient API capacity for the integration's sync frequency. Contact your ServiceNow administrator if you encounter rate limiting issues.