ServiceNow Connector
Ingest ServiceNow incidents, problems, and their work notes into CortexDB.
Tails ServiceNow records (incidents, problems, changes) and their comments / work notes, and writes them to CortexDB as experiences.
Two ways to run this connector
Self-hosted — pip install 'cortexdb-connectors[servicenow]' then cortexdb-sync sync servicenow.
Managed — CortexDB runs the connector as a worker. See the Connectors overview.
1. Prepare credentials
Self-host and dashboard use different auth
The managed dashboard uses OAuth (client id/secret). The self-hosted connector uses basic auth — a ServiceNow instance name plus a username and password (a dedicated integration user with read access to the tables you want is recommended).
What gets written
Each record and work note becomes a POST /v1/experience on the resolved scope (default
org:<org>/source:servicenow), with an entity reference to the record and metadata (table, sys_id,
state, a source_url).
Corrected fields
- The
idempotency_keyissnow:{table}:{sys_id}. - A problem's linked incidents are carried via a
thread=…label, notcontext.preceded_by.
Run it yourself
pip install 'cortexdb-connectors[servicenow]'
pip install cortexdb-cli && cortexdb init
export SNOW_INSTANCE=acme # required (e.g. acme for acme.service-now.com)
export SNOW_USERNAME=integration.user # required
export SNOW_PASSWORD=... # required
cortexdb-sync --api-url http://localhost:3141 sync servicenow
cortexdb-sync --api-url http://localhost:3141 watch servicenow --interval 300