ServiceNow Connector

SourceAPI DocsAPI ChangelogConnector Changelog

Description

ServiceNow is a platform for managing digital workflows. The ServiceNow component supports managing table records, incidents, attachments, CMDB entries, knowledge articles, and users.

API Documentation

This component was built using the ServiceNow REST API.

Connections

OAuth 2.0 Authorization Code

key: authorizationCode

ServiceNow supports OAuth 2.0 Authorization Code authentication. An OAuth application must be registered in the ServiceNow instance before configuring this connection.

Prerequisites

• A ServiceNow instance with administrator access
• Access to System OAuth > Application Registry in the ServiceNow instance

Setup Steps

1. Log in to the ServiceNow instance as an administrator
2. Navigate to System OAuth > Application Registry
3. Click New and select Create an OAuth API endpoint for external clients
4. Configure the application:
   • Name: Enter a descriptive name
   • Redirect URL: https://oauth2.prismatic.io/callback
5. Save the application
6. Copy the Client ID and Client Secret from the application record

Configure the Connection

• Authorize URL: Enter the OAuth authorization URL for the ServiceNow instance (e.g., https://dev12345.service-now.com/oauth_auth.do)
• Token URL: Enter the OAuth token URL for the ServiceNow instance (e.g., https://dev12345.service-now.com/oauth_token.do)
• Scopes: Enter space-separated OAuth scopes if required (optional)
• Client ID: Enter the Client ID from the OAuth application
• Client Secret: Enter the Client Secret from the OAuth application

Instance-Specific URLs

The Authorize URL and Token URL are specific to each ServiceNow instance. Replace dev12345 with the actual instance name.

Input	Notes	Example
Authorize URL	The OAuth 2.0 Authorization URL for ServiceNow	https://dev12345.service-now.com/oauth_auth.do
Client ID	Client Identifier of your app for ServiceNow
Client Secret	Client Secret of your app for ServiceNow
Scopes	Space separated OAuth 2.0 permission scopes for ServiceNow
Token URL	The OAuth 2.0 Token URL for ServiceNow	https://dev12345.service-now.com/oauth_token.do

Basic Username/Password

key: basic

ServiceNow supports Basic Authentication using a username and password.

Prerequisites

• A ServiceNow instance with an active user account
• The user account must have appropriate roles and permissions for the required API operations

Configure the Connection

• Username: Enter the ServiceNow account username
• Password: Enter the ServiceNow account password

Input	Notes	Example
Password	Password
Username	Username

OAuth 2.0 Client Credentials

key: serviceNowClientCredentials

ServiceNow supports OAuth 2.0 Client Credentials authentication, which lets an integration authorize as a ServiceNow system (service) account without an interactive user. An OAuth application must be registered in the ServiceNow instance before configuring this connection.

Prerequisites

• A ServiceNow instance with administrator access
• Access to System OAuth > Application Registry in the ServiceNow instance
• An OAuth application that permits the client credentials grant type

Setup Steps

1. Log in to the ServiceNow instance as an administrator
2. Navigate to System OAuth > Application Registry
3. Click New and select Create an OAuth API endpoint for external clients
4. Configure the application:
   • Name: Enter a descriptive name
5. Save the application
6. Copy the Client ID and Client Secret from the application record

Configure the Connection

• Instance URL: Enter the base URL of the ServiceNow instance (e.g., https://dev12345.service-now.com). The OAuth token URL is derived from it automatically.
• Client ID: Enter the Client ID from the OAuth application
• Client Secret: Enter the Client Secret from the OAuth application
• Scopes: Enter space-separated OAuth scopes if required (optional)

Instance-Specific URL

The Instance URL is specific to each ServiceNow instance. Replace dev12345 with the actual instance name.

Input	Notes	Example
Client ID	Client Identifier of your app for ServiceNow
Client Secret	Client Secret of your app for ServiceNow
Instance URL	The base URL of your ServiceNow instance (e.g., https://dev12345.service-now.com)	https://dev12345.service-now.com
Scopes	Space separated OAuth 2.0 permission scopes for ServiceNow
Token URL		{{#instanceUrl}}/oauth_token.do

Triggers

New and Updated Records

Retrieves existing and ongoing records for a specified ServiceNow table. Load history once, check for changes on a schedule, or both. | key: pollChangesTrigger

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Look-back Date	The date the initial sync starts from, in YYYY-MM-DD format. Cannot be a future date. Leave empty to start from the first recurrence with no backfill. When set, the initial sync seeds each record modified on or after this date once, ignoring the trigger's visibility filters.	2026-01-01
Show New Records	When enabled, newly created records will be included in the trigger output.	true
Show Updated Records	When enabled, records that were updated after the last poll will be included in the trigger output.	true
Table	The name of the ServiceNow table in which to create a record	incident

This trigger polls a selected ServiceNow table for records created or updated since its last recurrence, and can optionally load history once before it starts. See the ServiceNow developer documentation for the available tables and API versions.

How It Works

1. The trigger runs on the configured schedule
2. It queries the ServiceNow Table API using sysparm_query=sys_updated_on>{cursor} to fetch only records modified since the previous recurrence
3. Records are classified as created if sys_created_on is past the cursor; all other returned records are classified as updated
4. The trigger stores the timestamp it captured at the start of the recurrence as its new cursor

Initial sync

An initial sync seeds a complete starting state rather than a feed of changes. Inputs that narrow which changes are reported would leave permanent gaps in that starting state, so they are not applied to it, while inputs that shape how records are fetched still are. Setting Look-back Date starts the sync from that date on the first recurrence and seeds each record modified since it exactly once. The sync ignores Show New Records and Show Updated Records, the trigger's two visibility filters, which resume on every later recurrence. Leaving Look-back Date empty means no sync runs at all: the first recurrence records the cursor, emits nothing, and the trigger reports only changes from that point forward.

The sync window has no fixed upper bound: the query sends only a lower bound, so a record modified while the sync is running is swept into the sync itself. When the recurrence ends the trigger stores the timestamp it captured when that recurrence began, and the next recurrence resumes from exactly there, so nothing is lost between the two. Because that timestamp predates the fetch, a record modified in the interval between the two can be emitted once by the sync and again by the next recurrence. No field in the payload marks the handoff. The sync drains within a single recurrence whether or not batching is enabled, because the trigger reads the full matching record set and classifies it in memory.

The sync boundary is inclusive: a record modified exactly on the look-back date is seeded. Every later recurrence is exclusive of the previous cursor, so a record sitting exactly on it is not emitted a second time. This trigger has no page-size or field-selection inputs, so no fetch-shaping input is suppressed; the sync reads the same record set that a normal recurrence does.

Batching

Batching is enabled per flow on this trigger: each changed record is dispatched as its own execution, or grouped by the configured batch size. Batch size and batch concurrency can both be overridden per instance. Raising concurrency increases the request volume sent to ServiceNow.

To turn it on, select the flow's trigger, open the Flow control tab, and switch on Enable Batching. Under Batch Size, keep Trigger default or choose Custom batch size. Batch Concurrency is optional; leave it blank for no batch-level limit.

Enabling batching changes the shape a downstream step receives. With batching off, a step reads the full polling payload and finds the records under data.created and data.updated. With batching on, those two arrays do not exist: each record is dispatched on its own, tagged as changeType (either created or updated) with the record itself under record. Any step that reads data.created or data.updated must be updated before batching is turned on. Because batching is enabled per flow, the change is scoped to that flow rather than to the component or to other flows using the same trigger.

Returned Data

With batching off, the trigger returns the matching records grouped under created and updated. Fields shown are representative. The full response object includes additional properties.

Example Payload

{
  "data": {
    "created": [
      {
        "sys_id": "abc123def456",
        "number": "INC0010001",
        "short_description": "Cannot connect to VPN",
        "sys_created_on": "2024-01-16 10:30:00",
        "sys_updated_on": "2024-01-16 10:30:00",
        "state": "1"
      }
    ],
    "updated": [
      {
        "sys_id": "xyz789ghi012",
        "number": "INC0009875",
        "short_description": "Printer offline on floor 3",
        "sys_created_on": "2024-01-10 09:00:00",
        "sys_updated_on": "2024-01-16 14:22:00",
        "state": "6"
      }
    ]
  }
}

With batching on, each record is dispatched on its own instead.

Example Payload (batching enabled)

{
  "changeType": "created",
  "record": {
    "sys_id": "abc123def456",
    "number": "INC0010001",
    "short_description": "Cannot connect to VPN",
    "sys_created_on": "2024-01-16 10:30:00",
    "sys_updated_on": "2024-01-16 10:30:00",
    "state": "1"
  }
}

Notes

• Table Name is a free-form input: any valid ServiceNow table name is accepted. Common examples include incident, problem, change_request, and sc_task
• Instance URL must be the full base URL including the protocol (e.g., https://dev12345.service-now.com)
• A record is counted as created only when it was created after the cursor. A record created earlier and edited since is reported as updated, so the two arrays never contain the same record
• The trigger does not page its query, so a recurrence covering a very large window is bounded by the instance's own row limit rather than by an input

Example Payload for New and Updated Records⤓

Loading…

---

Data Sources

Select Attachment

Select an attachment from a list of attachments. | key: selectAttachment | type: picklist

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sysparm Query	Encoded query used to filter the result set. Syntax: sysparm_query=<col_name><operator><value>.	active=true^ORDERBYnumber^ORDERBYDESCcategory

---

Select Table

Select a table from the list of tables in ServiceNow. Returns the sys_id of the selected table. | key: selectTable | type: picklist

Input	Notes	Example
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sysparm Query	Encoded query used to filter the result set. Syntax: sysparm_query=<col_name><operator><value>.	active=true^ORDERBYnumber^ORDERBYDESCcategory

---

Actions

Create Configuration Item

Creates a single configuration item (CI) with the specified outbound and inbound relations within the specified Configuration Management Database (CMDB) table. | key: createConfigurationItem

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Class Name	CMDB class name. This is the name of the table that contains the desired CI records	cmdb_ci_linux_server
Configuration Item Attributes	The attributes of the configuration item to create.	{ "name": "lnux999", "firewall_status": "Intranet" }
Configuration Item Inbound Relations	The inbound relations of the configuration item to create.	[{"target":"{Sys_id of the target inbound relation to associate with the specified CI}","type":"{Sys_id of the type of relation to associate with the specified CI}"}]
Configuration Item Outbound Relations	The outbound relations of the configuration item to create.	[{"target":"{Sys_id of the target outbound relation to associate with the specified CI}","type":"{Sys_id of the type of relation to associate with the specified CI}"}]
Configuration Item Source	Entity that created/updated the information. This must be one of the choice values specified in the discovery_source field in the Configuration Item [cmdb_ci] table.	ServiceNow
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com

Example Payload for Create Configuration Item⤓

Loading…

---

Create Incident

Creates an Incident with the specified field names and values | key: createIncident

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Values	The names of the fields and their values to use when creating a record
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com

---

Create Table Record

Creates a record in the specified table with the specified field names and values. | key: createTableRecord

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Values	The names of the fields and their values to use when creating a record
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Table	The name of the ServiceNow table in which to create a record	incident

---

Create User

Creates a user with the specified field names and values. | key: createUser

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Name & Contact Information	First name, last name, and email address.
Values	The names of the fields and their values to use when creating a record
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Username	The login username used to authenticate the user.

---

Delete Attachment

Deletes the attachment with a specific sys_id value. | key: deleteAttachment

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	Sys_id value of the attachment to delete.	d71f7935c0a8016700802b64c67c11c6

Example Payload for Delete Attachment⤓

Loading…

---

Delete Configuration Item

Deletes the relation for the specified configuration item (CI). | key: deleteConfigurationItem

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Class Name	CMDB class name. This is the name of the table that contains the desired CI records	cmdb_ci_linux_server
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Relationship Sys ID	Sys Id of the relation to perform the operation on.	d71f7935c0a8016700802b64c67c11c6
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

Example Payload for Delete Configuration Item⤓

Loading…

---

Delete Incident

Delete an incident. | key: deleteIncident

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

---

Delete Table Record

Delete a record for a given ID in the specified table. | key: deleteTableRecord

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6
Table	The name of the ServiceNow table in which to create a record	incident

---

Delete User

Deletes a user. | key: deleteUser

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

---

Get Attachment

Returns the metadata for the attachment file with a specific sys_id value. | key: getAttachment

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

Example Payload for Get Attachment⤓

Loading…

---

Get Attachment File

Returns the binary file attachment with a specific sys_id value. | key: getAttachmentFile

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

Example Payload for Get Attachment File⤓

Loading…

---

Get CMDB Class Metadata

Returns the metadata for the specified CMDB class. | key: getCMDBClassMetaData

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Class Name	CMDB class name. This is the name of the table that contains the desired CI records	cmdb_ci_linux_server
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com

Example Payload for Get CMDB Class Metadata⤓

Loading…

---

Get Configuration Item Attributes

Returns attributes and relationship information for a specified configuration item (CI) record. | key: getConfigurationItemAttributes

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Class Name	CMDB class name. This is the name of the table that contains the desired CI records	cmdb_ci_linux_server
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

Example Payload for Get Configuration Item Attributes⤓

Loading…

---

Get Incident

Gets an incident by ID. | key: getIncident

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

---

Get Knowledge Article

Returns specific knowledge article content and its field values. | key: getKnowledgeArticle

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Article ID	Sys_id or knowledge base (KB) number of a knowledge article in the Knowledge [kb_knowledge] table.	KB0012345
Connection	The ServiceNow connection to use.
Fields	Comma-separated list of fields from the Knowledge [kb_knowledge] table to show details in results.	active,sys_id
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Language	List of comma-separated languages in two-letter ISO 639-1 language code format to restrict results to. Alternatively type 'all' to search in all valid installed languages on an instance.	en
Search ID	Optional unless using the 'Search Rank' input. Unique identifier of search that returned this article. You can retrieve this value (articles.id element) using the 'List Knowledge Articles' action.	kb_knowledge:3b0fccee0a0a0b9b00d34b36ea41a43e
Search Rank	Optional unless using the 'Search ID' input. Article search rank by click-rate (articles.rank) that you can retrieve using the 'List Knowledge Articles' action.	1
Update View	Update view count and record an entry for the article in the Knowledge Use [kb_use] table.	false

---

Get Knowledge Article Attachment

Returns a knowledge article attachment as a file. | key: getKnowledgeArticleAttachment

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Article Sys ID	Sys_id of the knowledge article with the attachment you intend to retrieve. Located in the Knowledge Bases [kb_knowledge] table.	f2765f9fc0a8011b0120ec1b352bf09b
Attachment Sys ID	Sys_id of record to which the attachment belongs.	f2765f9fc0a8011b0120ec1b352bf09b
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com

---

Get Table Record

Get a record for a given ID in the specified table. | key: getTableRecord

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6
Table	The name of the ServiceNow table in which to create a record	incident

---

Get User by ID

Gets a user by ID. | key: getUser

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

---

Get User by Username

Retrieve a user by username. | key: getUserByUsername

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Username	The login username used to authenticate the user.

---

List Attachments

Returns the metadata for multiple attachments. | key: listAttachments

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Fetch All	When enabled, automatically fetches all pages of results. The offset/limit inputs are ignored when this is enabled.	false
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Pagination	Page size and offset for paginated retrieval.
Sysparm Query	Encoded query used to filter the result set. Syntax: sysparm_query=<col_name><operator><value>.	active=true^ORDERBYnumber^ORDERBYDESCcategory

Example Payload for List Attachments⤓

Loading…

---

List Configuration Items

Returns the available configuration items (CI) for a specified Configuration Management Database (CMDB) class (table). | key: listConfigurationItems

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Class Name	CMDB class name. This is the name of the table that contains the desired CI records	cmdb_ci_linux_server
Connection	The ServiceNow connection to use.
Fetch All	When enabled, automatically fetches all pages of results. The offset/limit inputs are ignored when this is enabled.	false
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Pagination	Page size and offset for paginated retrieval.
Sysparm Query	All parameters are case-sensitive. Queries can contain more than one entry, such as sysparm_query=<col_name><operator><value>[<operator><col_name><operator><value>]. Refer to https://www.servicenow.com/docs/r/yokohama/api-reference/rest-apis/cmdb-instance-api.html#cmdb-GET-instance-classname for more information.	ORDERBY<col_name>

Example Payload for List Configuration Items⤓

Loading…

---

List Featured Knowledge Articles

Returns a list of the most-viewed knowledge articles and featured knowledge articles. | key: listFeaturedKnowledgeArticles

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Fetch All	When enabled, automatically fetches all pages of results. The offset/limit inputs are ignored when this is enabled.	false
Filters	Optional query controls to sort and refine the results.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Pagination	Page size and offset for paginated retrieval.

---

List Incidents

Gets a list of all incidents. | key: listIncidents

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Fetch All	When enabled, automatically fetches all pages of results. The offset/limit inputs are ignored when this is enabled.	false
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Pagination	Page size and offset for paginated retrieval.
Sysparm Query	Encoded query used to filter the result set. Syntax: sysparm_query=<col_name><operator><value>.	active=true^ORDERBYnumber^ORDERBYDESCcategory

---

List Knowledge Articles

Returns a list of knowledge base (KB) articles which can be searched and filtered using various parameters. | key: listKnowledgeArticles

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Fetch All	When enabled, automatically fetches all pages of results. The offset/limit inputs are ignored when this is enabled.	false
Filters	Optional query controls to sort and refine the results.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Pagination	Page size and offset for paginated retrieval.

---

List Most Viewed Knowledge Articles

Returns a list of knowledge articles prioritized by most-viewed. | key: listMostViewedKnowledgeArticles

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Fetch All	When enabled, automatically fetches all pages of results. The offset/limit inputs are ignored when this is enabled.	false
Filters	Optional query controls to sort and refine the results.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Pagination	Page size and offset for paginated retrieval.

---

List Table Records

Lists records in the specified table. | key: listTableRecords

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Fetch All	When enabled, automatically fetches all pages of results. The offset/limit inputs are ignored when this is enabled.	false
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Pagination	Page size and offset for paginated retrieval.
Sysparm Query	Encoded query used to filter the result set. Syntax: sysparm_query=<col_name><operator><value>.	active=true^ORDERBYnumber^ORDERBYDESCcategory
Table	The name of the ServiceNow table in which to create a record	incident

---

List Tables

Retrieve a list of all tables. | key: listTables

Input	Notes	Example
Connection	The ServiceNow connection to use.
Fetch All	When enabled, automatically fetches all pages of results. The offset/limit inputs are ignored when this is enabled.	false
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Pagination	Page size and offset for paginated retrieval.
Sysparm Fields	Comma-separated list of fields to return. If not specified, all fields are returned.	sys_id,label
Sysparm Query	Encoded query used to filter the result set. Syntax: sysparm_query=<col_name><operator><value>.	active=true^ORDERBYnumber^ORDERBYDESCcategory

---

List Users

Gets a list of all users. | key: listUsers

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Fetch All	When enabled, automatically fetches all pages of results. The offset/limit inputs are ignored when this is enabled.	false
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Pagination	Page size and offset for paginated retrieval.
Sysparm Query	Encoded query used to filter the result set. Syntax: sysparm_query=<col_name><operator><value>.	active=true^ORDERBYnumber^ORDERBYDESCcategory

---

Multipart Upload Attachment

Uploads a multipart file attachment. | key: multipartUploadAttachment

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
File	The file to attach to the record.
File Name	Name to give the attachment.	issue_screenshot
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	Sys_id of the record on the specified table to which you want to attach the file.	d71f7935c0a8016700802b64c67c11c6
Table	Name of the table to which you want to attach the file.	incident

Example Payload for Multipart Upload Attachment⤓

Loading…

---

Raw Request

Send raw HTTP request to ServiceNow. | key: rawRequest

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Data	The HTTP body payload to send to the URL.	{"exampleKey": "Example Data"}
File Data	File Data to be sent as a multipart form upload.	[{key: "example.txt", value: "My File Contents"}]
File Data File Names	File names to apply to the file data inputs. Keys must match the file data keys above.
Form Data	The Form Data to be sent as a multipart form upload.	[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header	A list of headers to send with the request.	User-Agent: curl/7.64.1
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Max Retry Count	The maximum number of retries to attempt. Specify 0 for no retries.	0
Method	The HTTP method to use.
Query Parameter	A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Response Type	The type of data you expect in the response. You can request json, text, or binary data.	json
Retry On All Errors	If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.	false
Retry Delay (ms)	The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.	0
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6
Table	The name of the ServiceNow table in which to create a record	incident
Timeout	The maximum time that a client will await a response to its request	2000
Use Exponential Backoff	Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.	false

---

Update Configuration Item

Updates a single configuration item (CI) with the specified outbound and inbound relations within the specified Configuration Management Database (CMDB) table. | key: updateConfigurationItem

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Class Name	CMDB class name. This is the name of the table that contains the desired CI records	cmdb_ci_linux_server
Configuration Item Attributes	The attributes of the configuration item to create.	{ "name": "lnux999", "firewall_status": "Intranet" }
Configuration Item Source	Entity that created/updated the information. This must be one of the choice values specified in the discovery_source field in the Configuration Item [cmdb_ci] table.	ServiceNow
Connection	The ServiceNow connection to use.
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

---

Update Incident

Updates an Incident with the specified field names and values | key: updateIncident

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Values	The names of the fields and their values to use when creating a record
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6

---

Update Table Record

Updates a record in the specified table with the specified field names and values. | key: updateTableRecord

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Values	The names of the fields and their values to use when creating a record
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6
Table	The name of the ServiceNow table in which to create a record	incident

---

Update User

Updates a user with the specified field names and values. | key: updateUser

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
Name & Contact Information	First name, last name, and email address.
Values	The names of the fields and their values to use when creating a record
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	The Sys ID of the record being queried	d71f7935c0a8016700802b64c67c11c6
Username	The login username used to authenticate the user.

---

Upload Attachment

Uploads a specified binary file as an attachment to a specified record. | key: uploadAttachment

Input	Notes	Example
API Version	The version of the ServiceNow API to use	v2
Connection	The ServiceNow connection to use.
File	The file to attach to the record.
File Name	Name to give the attachment.	issue_screenshot
Instance URL	The URL of the specific ServiceNow instance to use for API requests	https://instance.service-now.com
Sys ID	Sys_id of the record in the table specified in table_name that you want to attach the file to.	d71f7935c0a8016700802b64c67c11c6
Table	Name of the table to attach the file to.	incident

Example Payload for Upload Attachment⤓

Loading…

---

Changelog

2026-09-17

Expanded the New and Updated Records polling trigger and restructured action inputs into structured objects:

• Updated list actions (List Attachments, List Configuration Items, List Incidents, List Tables, List Table Records, List Users, List Knowledge Articles, List Featured Knowledge Articles, List Most Viewed Knowledge Articles) to group their page size and offset inputs into Pagination; Fetch All stays a top-level toggle
• Updated knowledge list actions (List Knowledge Articles, List Featured Knowledge Articles, List Most Viewed Knowledge Articles) to group their optional query controls into Filters
• Updated Create User and Update User to group their name and email inputs into Name & Contact Information
• Added inline action calling support to 34 actions for improved example output during configuration
• Added opt-in batching to the New and Updated Records trigger, dispatching each changed record individually or in configured batches so large backlogs drain in one recurrence; enabling it changes the shape a downstream step receives
• Added an optional Look-back Date input for performing an initial sync of records. The initial sync backfills every record modified on or after the specified date, seeding each once and ignoring the trigger's visibility filters; later recurrences are unaffected. Leave it empty to start from the first recurrence with no backfill

2026-07-14

Added an OAuth 2.0 Client Credentials connection, allowing authentication with ServiceNow system (service) accounts.

2026-05-21

Added Fetch All toggle input to list actions (List Incidents, List Table Records, List Tables, List Users, List Attachments, List CMDB Instances, List Knowledge Articles, List Featured Knowledge Articles, List Most Viewed Knowledge Articles, Get User By Username) to automatically retrieve all pages of results, bypassing the offset and limit inputs

2026-05-20

Applied automated security patches and code formatting updates

2026-04-30

Updated spectral version

2026-04-08

Added "New and Updated Records" polling trigger (pollChangesTrigger) that queries any ServiceNow table for records created or updated since the last poll, with configurable filtering for new vs. updated records.

2026-04-07

Various modernizations and documentation updates

2025-09-24

Added inline data sources for attachments

2025-07-22

Added CMDB (Configuration Management Database) actions for comprehensive IT asset and configuration management