--- title: Servicenow Cmdb slug: connectors/servicenow-cmdb docTags: createdAt: 2026-06-09T16:29:51.405Z --- The ServiceNow CMBD can be used to find CI(Configuration Item) records in the ServiceNow CMDB(Configuration Management Database) and respectively pull the record enrichment. ## Prerequisites The ServiceNow CMBD connector requires an URL, an Username, and a Password to interact with the API. ## Capabilities This connector provides the following capabilities: - Get CI Records ## Notes For more information about the API and its capabilities: - [ServiceNow CMBD API Documentation](https://developer.servicenow.com/dev.do#!/reference/api/utah/rest/cmdb-instance-api) This plugin was last tested against product version: v1 API. # Configurations ## HTTP Basic Authentication Authenticates using username and password. ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------- | ---------------------------------- | -------- | ------------ | | url | A URL to the target host. | string | Required | | username | Username | string | Required | | password | Password | string | Required | | verify\_ssl | Verify SSL certificate | boolean | Optional | | http\_proxy | A proxy to route requests through. | string | Optional | # Actions ## Get CI Records Returns the available configuration items (CI) for a specified Configuration Management Database (CMDB) class (table). ### Endpoint - **URL:** `api/now/v1/table/{{className}}` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | --------------------------- | -------- | ------------ | ---------------------------------------- | | `path_parameters.className` | string | Required | Parameters for the Get CI Records action | | `parameters.sysparm_limit` | number | Optional | Parameters for the Get CI Records action | | `parameters.sysparm_offset` | number | Optional | Parameters for the Get CI Records action | | `parameters.sysparm_query` | string | Optional | Parameters for the Get CI Records action | ### Input Example `{"parameters":{"sysparm_limit":100,"sysparm_offset":0,"sysparm_query":"sysparm_query=operating_system=Windows"},"path_parameters":{"className":"cmdb_ci_linux_server"}}` ### Output | **Parameter** | **Type** | **Description** | | --------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `result` | array | Result of the operation | | `result.sys_id` | string | Unique identifier | | `result.name` | string | Name of the resource | ### Output Example `{"status_code":200,"response_headers":{"Set-Cookie":"JSESSIONID=D5DCFFBDAC700FA9E91AE22C11F4F6A2; Path=/; HttpOnly;Secure, glide_user...","Server-Timing":"sem_wait;dur=0, sesh_wait;dur=0","Content-Encoding":"gzip","X-Is-Logged-In":"true","X-Transaction-ID":"95fef03d1541","X-Total-Count":"4","X-Content-Type-Options":"nosniff","Pragma":"no-store,no-cache","Cache-Control":"no-cache,no-store,must-revalidate,max-age=-1","Expires":"0","Content-Type":"application/json;charset=UTF-8","Transfer-Encoding"...` # Response Headers | **Header** | **Description** | **Example** | | ------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Cache-Control | Directives for caching mechanisms | no-cache,no-store,must-revalidate,max-age=-1 | | Connection | HTTP response header: Connection | keep-alive | | Content-Encoding | HTTP response header: Content-Encoding | gzip | | Content-Type | The media type of the resource | application/json;charset=UTF-8 | | Date | The date and time at which the message was originated | Thu, 28 Sep 2023 12:55:08 GMT | | Expires | The date/time after which the response is considered stale | 0 | | Keep-Alive | HTTP response header: Keep-Alive | timeout=70 | | Pragma | HTTP response header: Pragma | no-store,no-cache | | Server | Information about the software used by the origin server | ServiceNow | | Server-Timing | HTTP response header: Server-Timing | sem\_wait;dur=0, sesh\_wait;dur=0 | | Set-Cookie | HTTP response header: Set-Cookie | JSESSIONID=D5DCFFBDAC700FA9E91AE22C11F4F6A2; Path=/; HttpOnly;Secure, glide\_user=; Max-Age=0; Expires=Thu, 01-Jan-1970 00:00:10 GMT; Path=/; Secure; HttpOnly, glide\_user\_session=; Max-Age=0; Expires=Thu, 01-Jan-1970 00:00:10 GMT; Path=/; Secure; HttpOnly, glide\_user\_route=glide.516eb3ac9d9c5f64cf3e643031a64e92; Max-Age=2147483647; Expires=Tue, 16-Oct-2091 16:09:15 GMT; Path=/; Secure; HttpOnly, glide\_session\_store=51FEF03D472571107C36CD9BD36D4315; Max-Age=1800; Expires=Thu, 28-Sep-2023 13:25:08 GMT; Path=/; Secure; HttpOnly, BIGipServerpool\_dev52829=999184138.50240.0000; path=/; Httponly; Secure | | Strict-Transport-Security | HTTP response header: Strict-Transport-Security | max-age=63072000; includeSubDomains | | Transfer-Encoding | HTTP response header: Transfer-Encoding | chunked | | X-Content-Type-Options | HTTP response header: X-Content-Type-Options | nosniff | | X-Is-Logged-In | HTTP response header: X-Is-Logged-In | true | | X-Total-Count | HTTP response header: X-Total-Count | 4 | | X-Transaction-ID | HTTP response header: X-Transaction-ID | 95fef03d1541 |