---
title: "ServiceNow"
description: "Reference for the Tracecat ServiceNow integration: registered actions, required secrets, expected inputs, and example workflow usage."
---

{/* Auto-generated by scripts/generate_tool_docs.py; do not edit by hand. */}
## 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.

</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.

</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.

</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.

</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.

</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>
