> ## Documentation Index
> Fetch the complete documentation index at: https://tracecat-feat-mcp-cred-setup.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ServiceNow

> Reference for the Tracecat ServiceNow integration: registered actions, required secrets, expected inputs, and example workflow usage.

## Create ServiceNow record

Action ID: `tools.servicenow.create_record`

Create a record in a ServiceNow table.

Reference: [https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html)

### Secrets

Required secrets:

* `servicenow_oauth`: OAuth token `SERVICENOW_SERVICE_TOKEN`.

### Input fields

<ParamField path="base_url" type="string" required>
  Base API URL, e.g. [https://example.service-now.com/api/now](https://example.service-now.com/api/now).
</ParamField>

<ParamField path="record" type="object" required>
  JSON payload for the new record.
</ParamField>

<ParamField path="table_name" type="string" required>
  ServiceNow table name, e.g. 'incident', 'sys\_user'.
</ParamField>

<ParamField path="params" type="object | null">
  Optional query parameters such as sysparm\_display\_value.

  Default: `null`.
</ParamField>

## Delete ServiceNow record

Action ID: `tools.servicenow.delete_record`

Delete a ServiceNow table record by sys\_id.

Reference: [https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html)

### Secrets

Required secrets:

* `servicenow_oauth`: OAuth token `SERVICENOW_SERVICE_TOKEN`.

### Input fields

<ParamField path="base_url" type="string" required>
  Base API URL, e.g. [https://example.service-now.com/api/now](https://example.service-now.com/api/now).
</ParamField>

<ParamField path="record_id" type="string" required>
  Unique record identifier (sys\_id).
</ParamField>

<ParamField path="table_name" type="string" required>
  ServiceNow table name, e.g. 'incident', 'sys\_user'.
</ParamField>

<ParamField path="params" type="object | null">
  Optional query parameters such as sysparm\_display\_value.

  Default: `null`.
</ParamField>

## Get ServiceNow record

Action ID: `tools.servicenow.get_record`

Retrieve a record from a ServiceNow table by sys\_id.

Reference: [https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html)

### Secrets

Required secrets:

* `servicenow_oauth`: OAuth token `SERVICENOW_SERVICE_TOKEN`.

### Input fields

<ParamField path="base_url" type="string" required>
  Base API URL, e.g. [https://example.service-now.com/api/now](https://example.service-now.com/api/now).
</ParamField>

<ParamField path="record_id" type="string" required>
  Unique record identifier (sys\_id).
</ParamField>

<ParamField path="table_name" type="string" required>
  ServiceNow table name, e.g. 'incident', 'sys\_user'.
</ParamField>

<ParamField path="params" type="object | null">
  Optional query parameters such as sysparm\_fields or sysparm\_display\_value.

  Default: `null`.
</ParamField>

## Query ServiceNow records

Action ID: `tools.servicenow.query_records`

Query a ServiceNow table with optional filters.

Reference: [https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html)

### Secrets

Required secrets:

* `servicenow_oauth`: OAuth token `SERVICENOW_SERVICE_TOKEN`.

### Input fields

<ParamField path="base_url" type="string" required>
  Base API URL, e.g. [https://example.service-now.com/api/now](https://example.service-now.com/api/now).
</ParamField>

<ParamField path="table_name" type="string" required>
  ServiceNow table name, e.g. 'incident', 'sys\_user'.
</ParamField>

<ParamField path="params" type="object | null">
  Optional query parameters such as sysparm\_query, sysparm\_fields, or sysparm\_limit.

  Default: `null`.
</ParamField>

## Update ServiceNow record

Action ID: `tools.servicenow.update_record`

Update fields on a ServiceNow table record.

Reference: [https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/build/applications/concept/api-rest.html)

### Secrets

Required secrets:

* `servicenow_oauth`: OAuth token `SERVICENOW_SERVICE_TOKEN`.

### Input fields

<ParamField path="base_url" type="string" required>
  Base API URL, e.g. [https://example.service-now.com/api/now](https://example.service-now.com/api/now).
</ParamField>

<ParamField path="fields" type="object" required>
  Fields to update on the record.
</ParamField>

<ParamField path="record_id" type="string" required>
  Unique record identifier (sys\_id).
</ParamField>

<ParamField path="table_name" type="string" required>
  ServiceNow table name, e.g. 'incident', 'sys\_user'.
</ParamField>

<ParamField path="params" type="object | null">
  Optional query parameters such as sysparm\_display\_value.

  Default: `null`.
</ParamField>