Get a ServiceNow integration

Retrieves a single ServiceNow enrichment integration by ID, including its CMDB tables, field mappings, the current sync status of each table, and credentials.

Early Access

This API is in Early Access and may change at any time. Contact your PagerDuty account team to request access.

Scoped OAuth requires: contextual_data.read

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

integration_id*string

Base32-encoded UUID v7 (26 uppercase alphanumeric characters) identifying the ServiceNow enrichment integration.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Response Body

`application/json`

curl -X GET "https://example.com/enrichment/integrations/servicenow/{integration_id}" \  -H "Accept: application/vnd.pagerduty+json;version=2"

{  "integration": {    "id": "01HQXYZ9ABCDEFGHIJKLMNOPQR",    "name": "Production CMDB Integration",    "description": "Enrichment data from production ServiceNow instance",    "cmdb_tables": [      {        "id": "01HTABC8DEFGHIJKLMNOPQRSTU",        "display_name": "Network Switches",        "ci_table_name": "cmdb_ci_ip_switch",        "query_filter": "operational_status=1",        "field_mappings": [          {            "servicenow_field": "name",            "event_field": "source",            "type": "query"          },          {            "servicenow_field": "operational_status",            "event_field": "Operational Status",            "type": "enriched"          },          {            "servicenow_field": "support_group",            "event_field": "Support Group",            "type": "enriched"          },          {            "servicenow_field": "sys_class_name",            "event_field": "CI Class",            "type": "enriched"          }        ],        "status": "active",        "created_at": "2026-06-30T18:24:00Z",        "updated_at": "2026-06-30T19:05:00Z",        "deleted_at": null      }    ],    "credentials": {      "id": "01HV2C3D4E5F6G7H8J9K0LMNPQ",      "instance_endpoint": "https://your-instance.service-now.com",      "user": "integration_user",      "created_at": "2026-06-30T18:20:00Z",      "updated_at": "2026-06-30T18:20:00Z",      "deleted_at": null    },    "created_at": "2026-06-30T18:24:00Z",    "updated_at": "2026-06-30T19:05:00Z"  }}

Get a ServiceNow integration

Early Access

Authorization

Path Parameters

Header Parameters

Response Body

200application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`