Skip to main content

API key permissions for the outbound ServiceNow integration

You must create an API key in APEX AIOps Incident Management to use with the outbound ServiceNow integration. In most cases, the API key requires these permissions to allow bidirectional communication:

Permission

Level

Incidents and Insights

Full Access

Maintenance

Full Access

If the update set will be used to configure Incident Management, or if legacy catalog-based maintenance windows are in use, then additional permissions are required.

The following table lists the operations that require configuration changes and additional API key permissions:

When performing this operation:

Change this setting in the ServiceNow update set:

Include Full Access for this permission in the Incident Management API key:

Creating and using a data catalog to manage maintenance windows

  • Enable Moogsoft Maintenance Window integration: true

  • Use New Maintenance Windows Feature: false

Catalog

Using a bidirectional integration

None

Incidents and Insights

Creating outbound webhooks

  • Enable Moogsoft Incident integration: true

Integrations

Creating and managing scheduled maintenance windows

  • Enable Moogsoft Maintenance Window integration: true

  • Use New Maintenance Windows Feature: true

Maintenance

Creating a new Incident Management user to use when closing Incident Management incidents

  • Enable closing of Moogsoft Incident: true

  • Moogsoft Assignee Email: populated

  • Create Moogsoft Assignee: true

User

Creating a workflow to tag incidents with maintenance window details using catalog entries

  • Enable Moogsoft Maintenance Window integration: true

  • Use New Maintenance Windows Feature: false

Workflows

In this section: