Create a ServiceNow integration

Creates a ServiceNow enrichment integration with one or more CMDB table configurations. Only one integration is allowed per account. Each CMDB table must define between 2 and 20 field mappings, and an integration may contain at most 8 tables. Credentials are managed separately through the credentials endpoints.

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

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Header Parameters

Accept*string

The Accept header is used as a versioning header.

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

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Request Body

application/json

The ServiceNow enrichment integration to create. Credentials are added separately through the credentials endpoint.

TypeScript Definitions

Use the request body type in TypeScript.

name*string

The name of the integration.

Lengthlength <= 100

description?string

An optional description of the integration.

Lengthlength <= 500

cmdb_tables*array<>

The ServiceNow CMDB table configurations. An integration must have between 1 and 8 tables.

Items1 <= items <= 8

Response Body

`application/json`

curl -X POST "https://example.com/enrichment/integrations/servicenow" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "name": "Production CMDB Integration",    "description": "Enrichment data from production ServiceNow instance",    "cmdb_tables": [      {        "display_name": "Network Switches",        "ci_table_name": "cmdb_ci_ip_switch",        "query_filter": "operational_status=1",        "field_mappings": [          {            "servicenow_field": "name",            "event_field": "source"          },          {            "servicenow_field": "operational_status",            "event_field": "Operational Status"          },          {            "servicenow_field": "support_group",            "event_field": "Support Group"          },          {            "servicenow_field": "sys_class_name",            "event_field": "CI Class"          }        ]      }    ]  }'

{  "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": "disabled",        "created_at": "2026-06-30T18:24:00Z",        "updated_at": "2026-06-30T18:24: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-30T18:24:00Z"  }}

Create a ServiceNow integration

Early Access

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`