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

# servicenow

> Incidents, requests, and workflows

**Server path:** `/servicenow` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                          | Description                                                     |
| ------------------------------------------------------------- | --------------------------------------------------------------- |
| [`servicenow_list_incidents`](#servicenow_list_incidents)     | List incidents in ServiceNow with optional filters              |
| [`servicenow_get_apps`](#servicenow_get_apps)                 | Get ServiceNow applications                                     |
| [`servicenow_get_incident`](#servicenow_get_incident)         | Get details of a specific ServiceNow incident using its sys\_id |
| [`servicenow_get_current_user`](#servicenow_get_current_user) | Get current user account details from ServiceNow                |
| [`servicenow_create_incident`](#servicenow_create_incident)   | Create a new incident in ServiceNow                             |
| [`servicenow_update_incident`](#servicenow_update_incident)   | Update an existing ServiceNow incident                          |

***

## servicenow\_list\_incidents

List incidents in ServiceNow with optional filters

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                                                         |
| ---------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------- |
| `active`   | boolean | No       | —       | Ticket status either true or false                                                  |
| `priority` | number  | No       | —       | Priority of the ticket ranges from 1 to 4 with 1 being the highest & 4 being lowest |
| `state`    | string  | No       | —       | State of the ticket                                                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "active": {
        "type": "boolean",
        "description": "Ticket status either true or false"
      },
      "priority": {
        "type": "number",
        "description": "Priority of the ticket ranges from 1 to 4 with 1 being the highest & 4 being lowest"
      },
      "state": {
        "type": "string",
        "enum": [
          "New",
          "In Progress",
          "On Hold",
          "Resolved",
          "Closed",
          "Canceled"
        ],
        "description": "State of the ticket"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## servicenow\_get\_apps

Get ServiceNow applications

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## servicenow\_get\_incident

Get details of a specific ServiceNow incident using its sys\_id

**Parameters:**

| Parameter | Type   | Required | Default | Description             |
| --------- | ------ | -------- | ------- | ----------------------- |
| `sysId`   | string | Yes      | —       | sys\_id of the incident |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "sysId": {
        "type": "string",
        "description": "sys_id of the incident"
      }
    },
    "required": [
      "PCID",
      "sysId"
    ]
  }
  ```
</Expandable>

***

## servicenow\_get\_current\_user

Get current user account details from ServiceNow

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## servicenow\_create\_incident

Create a new incident in ServiceNow

**Parameters:**

| Parameter           | Type   | Required | Default | Description                                                           |
| ------------------- | ------ | -------- | ------- | --------------------------------------------------------------------- |
| `short_description` | string | Yes      | —       | Short description of the incident                                     |
| `description`       | string | Yes      | —       | Description of the incident                                           |
| `assigned_to`       | string | No       | —       | Person assigned to for the incident                                   |
| `priority`          | string | No       | —       | Priority of the incident                                              |
| `category`          | string | No       | —       | Category of the incident hardware, software, network, inquiries, etc. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "short_description": {
        "type": "string",
        "description": "Short description of the incident"
      },
      "description": {
        "type": "string",
        "description": "Description of the incident"
      },
      "assigned_to": {
        "type": "string",
        "description": "Person assigned to for the incident"
      },
      "priority": {
        "type": "string",
        "enum": [
          "1-Critical",
          "2-High",
          "3-Medium",
          "4-Low",
          "5-Planning"
        ],
        "description": "Priority of the incident"
      },
      "category": {
        "type": "string",
        "description": "Category of the incident hardware, software, network, inquiries, etc."
      }
    },
    "required": [
      "PCID",
      "short_description",
      "description"
    ]
  }
  ```
</Expandable>

***

## servicenow\_update\_incident

Update an existing ServiceNow incident

**Parameters:**

| Parameter     | Type   | Required | Default | Description                         |
| ------------- | ------ | -------- | ------- | ----------------------------------- |
| `sysId`       | string | Yes      | —       | sys\_id of the incident             |
| `state`       | string | No       | —       | State of the ticket                 |
| `assigned_to` | string | No       | —       | Person assigned to for the incident |
| `work_notes`  | string | No       | —       | Work notes of the incident          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "sysId": {
        "type": "string",
        "description": "sys_id of the incident"
      },
      "state": {
        "type": "string",
        "enum": [
          "New",
          "In Progress",
          "On Hold",
          "Resolved",
          "Closed",
          "Canceled"
        ],
        "description": "State of the ticket"
      },
      "assigned_to": {
        "type": "string",
        "description": "Person assigned to for the incident"
      },
      "work_notes": {
        "type": "string",
        "description": "Work notes of the incident"
      }
    },
    "required": [
      "PCID",
      "sysId"
    ]
  }
  ```
</Expandable>