Capability library / Application package

ServiceNow package v1.0.0

ServiceNow Table API on the customer's own instance: read, create and update incidents, read and create change requests, and read catalog items.

Review state: Reviewed · Distributable: yes, digest matches the release manifest

This page describes AAES Govern’s controls. AAES Operate has private-work permissions, operational reviews and recorded-spend limits; it does not include Govern. About AAES Govern

Before you enable this package

The instance host is a reserved .invalid placeholder that fails closed until substituted. The Table API enforces the calling user's ACLs: the registration records the endpoint, not the instance's authorization decision. Change-request approval is a documented exclusion, not a registered capability.

Read each action's effects and exclusions below. Before installation, also read the complete package requirements, including credential issuance, scope, expiry, and provider permissions. These are deployment prerequisites, not capabilities this package supplies.

Capabilities (6)

Each capability below is one registered operation. The complete package JSON includes its exact network destination allowlist. The repository stores it at packs/servicenow.json and embeds a copy in the release binary.

Risk tiers. R0 is the minimum for reads. R2 is the minimum for write, create, update, execute, and invoke. R3 is the minimum for delete, send, pay, deploy, approve, share, and transfer. Operators can raise these levels. A minimum tier does not measure the operation's business or confidentiality risk.

Field guide. Endpoint is the service address and request method. Connector is the adapter that makes the call. Custody describes how the credential is held; the credential reference identifies the value to resolve. Data class sets handling requirements: pii means personal data, financial means financial records, and internal means internal organizational data.

servicenow.incident.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://servicenow-instance.invalid/api/now/table/incident
Connector
http
Custody
customer_vault
Credential ref
secret-ref-servicenow-oauth-token
Data class
pii

Read incident.

Retrieve incident records from the collection endpoint; this pack registers the collection read only — the Table API's single-record read (GET /now/table/{tableName}/{sys_id}) is not registered. Incident records carry caller, assignee and watch-list user references, so the read is classified as pii (personal data).

The host is a reserved placeholder: substitute the customer's instance host before enabling.

servicenow.incident.create v1.0.0R2

Kind
tool
Action
create
Endpoint
POST https://servicenow-instance.invalid/api/now/table/incident
Connector
http
Custody
customer_vault
Credential ref
secret-ref-servicenow-oauth-token
Data class
pii

Create incident.

Insert one incident record; the Table API inserts one record per call and does not support multiple-record insertion. The record can name a caller and other users, so the capability is classified as pii (personal data).

The host is a reserved placeholder: substitute the customer's instance host before enabling.

servicenow.incident.update v1.0.0R2

Kind
tool
Action
update
Endpoint
PATCH https://servicenow-instance.invalid/api/now/table/incident/SYS_ID
Connector
http
Custody
customer_vault
Credential ref
secret-ref-servicenow-oauth-token
Data class
pii

Update incident.

Update one incident record with the name-value pairs in the request body; fields prefixed sys_ are system-generated and cannot be updated. The Table API also documents PUT for updates; this pack registers PATCH only.

The host is a reserved placeholder to substitute before enabling, and SYS_ID binds to the target record at call time.

servicenow.change_request.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://servicenow-instance.invalid/api/now/table/change_request
Connector
http
Custody
customer_vault
Credential ref
secret-ref-servicenow-oauth-token
Data class
pii

Read change request.

Retrieve change request records from the collection endpoint; this pack registers the collection read only — the Table API's single-record read (GET /now/table/{tableName}/{sys_id}) is not registered. Change requests carry requested-by and assigned-to user references, so the read is classified as pii (personal data).

The host is a reserved placeholder: substitute the customer's instance host before enabling.

servicenow.change_request.create v1.0.0R2

Kind
tool
Action
create
Endpoint
POST https://servicenow-instance.invalid/api/now/table/change_request
Connector
http
Custody
customer_vault
Credential ref
secret-ref-servicenow-oauth-token
Data class
pii

Create change request.

Insert one change request record; the Table API inserts one record per call. The insert accepts the name-value pairs the calling user is permitted to set, subject to the instance's ACLs and business rules — this registration does not restrict which fields a request may carry, so what workflow state a newly inserted record enters, and whether it starts unapproved, is decided by the instance's configuration, not by this pack.

Nothing in this pack approves a change: the approval capability was considered and removed (see the pack notes).

The host is a reserved placeholder: substitute the customer's instance host before enabling.

servicenow.catalog_item.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://servicenow-instance.invalid/api/now/table/sc_cat_item
Connector
http
Custody
customer_vault
Credential ref
secret-ref-servicenow-oauth-token
Data class
internal

Read catalog item.

Retrieve service catalog item records from the collection endpoint; this pack registers the collection read only. Catalog items are the organization's catalog content, classified as internal data; this reads the catalog only — ordering an item is the Service Catalog API (order_now), which this pack does not register.

The host is a reserved placeholder: substitute the customer's instance host before enabling.

Credential reference

The credential field names a reference rather than containing credential material. Packs are designed not to contain secrets; the format checks cover only known credential formats and cannot prove that arbitrary text contains no secrets. Installing a package registers its capabilities. Configure the provider credentials, endpoints, and network access, then test the integration in your environment before enabling it.

Reference
secret-ref-servicenow-oauth-token
Custody
customer_vault
Injection
header (Authorization)

Configure the value and injection format specified in the package. Assign responsibility for credential rotation and revocation, restrict provider permissions, and keep credential material out of logs and responses.

Complete credential requirements

An OAuth2 access token for the customer's own ServiceNow instance, held in the client's own secret manager. The stored material must be the complete Authorization header value (scheme included): 'Bearer ' followed by the access token. An external deployment process obtains the token from the instance and renews it when it expires — storing the OAuth client credentials under this reference does not make the HTTP injector perform OAuth: the injector injects the stored value verbatim, so refresh ownership (including any refresh-token grant the deployment chooses to use) sits entirely with that external process.

Access tokens expire and can be revoked at the instance; an expired or revoked value fails closed. The token's access is the token user's access — grant the user the minimum roles (for example itil for the incident and change tables) that make these capabilities work, and nothing more.

Executor hygiene: the value must live only in executor memory for the lifetime of a call, must never be written to logs, traces or diagnostics, and must not appear in crash dumps; a deployment that cannot meet that bar must not enable the pack.

Resources

  • servicenow-instance (api, pii): https://servicenow-instance.invalid/api/now

Technical package and review record

Complete provider requirements and exclusions

The endpoint host 'servicenow-instance.invalid' is a reserved non-production placeholder (an RFC 2606 reserved TLD): substitute the customer's instance host before enabling, in every endpoint, in the resource locator and in every egress allowlist entry. The allowlist matches exactly, so endpoints and allowlist must be substituted together, and substitution is a required deployment step — the reserved host being allowlisted does not make an unsubstituted pack safe to enable.

The pack does not create the OAuth application or mint tokens: an external deployment process registers the OAuth client with the instance admin, obtains access tokens from the customer's own instance, and stores and renews the complete header value described in the credential note. The Table API enforces the calling user's ACLs and roles, so a capability works only if the token's user (for example an itil user) is permitted the operation; the registration records the endpoint, not the instance's authorization decision.

Excluded operation: servicenow.change_request.approve. Approving a change request by PATCHing the record's approval field was considered and removed — the retrieved Table API documentation establishes PATCH /now/table/{tableName}/{sys_id} as a generic name-value update but does not establish that setting the change_request record's approval field performs a workflow approval; change approvals run through approval records and the Change Management REST API's approval operation, each a different registration requiring its own review, and this pack registers neither.

Nothing in this pack approves a change. Further documented exclusions, from the retrieved Table API documentation: DELETE /now/table/{tableName}/{sys_id} exists in the API and is deliberately not registered; incident or change deletion is excluded; PUT /now/table/{tableName}/{sys_id} also exists, and only PATCH is registered for updates; POST inserts one record per call — multiple-record insertion is not supported by the Table API.

The Attachment API, Stats API, Import Set API and Service Catalog API (order_now) are separate ServiceNow APIs this pack does not register — reading sc_cat_item returns catalog content and orders nothing. AAES has not been certified by ServiceNow; the endpoints here are configuration to review and test; the vendor has not endorsed it.

Download the complete package JSON for exact network allowlists, credential requirements, exclusions, and setup notes. Read these requirements before installation.

The full documentation review record is supplied in the evaluation package. The evaluation package runs in your environment and comes only with the paid design partnership. This page reproduces the source links and review block; the full record is available for evaluation. Discuss a design partnership to inspect it before installation.

Review block

This section reproduces the review block recorded in the pack file. The evidence and approval record is separate: for a reviewed pack, it is in the evaluation materials and in the release binary's embedded assets.

Review completed: 2026-09-23

3 sources, retrieved 2026-09-21, 2026-09-23

Current documentation links are navigation aids. They do not change the package, its historical sources or its review date. Review dates describe a documentation review, not a live integration test. No package is provider-endorsed or yet tested against a live provider tenant.

Release identity

SHA-256 of the pack file bytes: fb544a6f963eba2e0ab01537d6085bd1c39fd2c2d93ad5dbb394b2884440c608

Distributable: yes, digest matches the release manifest. Editing a package changes its release identity. A deployment plan checks its own file digests; it does not restore reviewed status or authenticate approval.