> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ServiceNow

> Integrate Plerion with ServiceNow to automatically create and update incidents, streamlining IT service management (ITSM) workflows and reducing manual effort.

With the [ServiceNow integration](https://app.plerion.com/settings/integrations/add/ServiceNow/ServiceNow), you can create incidents from Plerion alerts directly in ServiceNow, keeping your team in their existing workflows.

<Warning>
  **Note:** This is a one-way outbound integration. Alerts created or updated in Plerion will appear in ServiceNow, but changes made in ServiceNow will not sync back to Plerion.
</Warning>

## Steps to integrate ServiceNow with Plerion

<Steps>
  <Step title="On the Plerion dashboard, go to Settings > Integrations">
    <Frame>
      <img src="https://mintcdn.com/pleriondocs/0nB_vPvBhqRlH6jO/images/integrations/servicenow/settings-integrations-sidenav.png?fit=max&auto=format&n=0nB_vPvBhqRlH6jO&q=85&s=bc31a9a2366c773b630ade757817b88d" alt="Plerion dashboard showing Settings expanded with Integrations selected" width="655" height="853" data-path="images/integrations/servicenow/settings-integrations-sidenav.png" />
    </Frame>
  </Step>

  <Step title="Find ServiceNow and click the + button">
    <Frame>
      <img src="https://mintcdn.com/pleriondocs/0nB_vPvBhqRlH6jO/images/integrations/servicenow/add-servicenow-integration.png?fit=max&auto=format&n=0nB_vPvBhqRlH6jO&q=85&s=40ef256bd08910374d151422bf717d92" alt="Integrations page with ServiceNow option and plus button to add integration" width="1266" height="1484" data-path="images/integrations/servicenow/add-servicenow-integration.png" />
    </Frame>
  </Step>

  <Step title="On the Connect ServiceNow page, enter your integration details">
    * **User Name:** Your ServiceNow username
    * **Password:** Your ServiceNow password
    * **Domain:** Your ServiceNow instance URL (e.g. `https://example.servicenow.com`)

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/0nB_vPvBhqRlH6jO/images/integrations/servicenow/setting-up-servicenow-integration.png?fit=max&auto=format&n=0nB_vPvBhqRlH6jO&q=85&s=fe8f59c420b5654b76e1fc68ccbba71a" alt="ServiceNow integration setup page with fields for name, username, password, and domain" width="2322" height="1310" data-path="images/integrations/servicenow/setting-up-servicenow-integration.png" />
    </Frame>
  </Step>

  <Step title="Test your ServiceNow integration">
    After adding ServiceNow, you can send a test message to confirm the setup.\
    Click `Send test message` in Plerion.
  </Step>

  <Step title="Review your test incident in ServiceNow">
    If the test is successful, a new incident will appear in your ServiceNow **Incidents** section.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/0nB_vPvBhqRlH6jO/images/integrations/servicenow/servicenow-test-message-platform.jpg?fit=max&auto=format&n=0nB_vPvBhqRlH6jO&q=85&s=7c408b5a3dc7076a91ca6b9ec86229e8" alt="ServiceNow platform showing Incidents highlighted" width="1024" height="678" data-path="images/integrations/servicenow/servicenow-test-message-platform.jpg" />
    </Frame>

    <br />

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/0nB_vPvBhqRlH6jO/images/integrations/servicenow/servicenow-test-message-plerion-test-issue.png?fit=max&auto=format&n=0nB_vPvBhqRlH6jO&q=85&s=cbc9f826b6ea3ca0f08a63469b94192a" alt="ServiceNow incident list showing newly created test incident from Plerion" width="2854" height="646" data-path="images/integrations/servicenow/servicenow-test-message-plerion-test-issue.png" />
    </Frame>
  </Step>
</Steps>

## Obtaining ServiceNow credentials

<Steps>
  <Step title="Go to the ServiceNow website" />

  <Step title="Log in and open your profile">
    After logging in, click your profile image in the top-right corner.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/0nB_vPvBhqRlH6jO/images/integrations/servicenow/servicenow-profile.jpg?fit=max&auto=format&n=0nB_vPvBhqRlH6jO&q=85&s=0881d8769d02be3aa4573da000ab5dcc" alt="ServiceNow portal showing profile dropdown" width="1080" height="103" data-path="images/integrations/servicenow/servicenow-profile.jpg" />
    </Frame>
  </Step>

  <Step title="Click 'Manage instance password'">
    This will allow you to generate or reset your credentials.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/0nB_vPvBhqRlH6jO/images/integrations/servicenow/manage-password.jpg?fit=max&auto=format&n=0nB_vPvBhqRlH6jO&q=85&s=f8240ffa1ad1c1bd2a00c627e063a24a" alt="ServiceNow profile settings page with Manage instance password option highlighted" width="1080" height="433" data-path="images/integrations/servicenow/manage-password.jpg" />
    </Frame>
  </Step>

  <Step title="Use these credentials in Plerion">
    Enter the generated username and password when setting up your ServiceNow integration in Plerion.
  </Step>
</Steps>

<Warning>
  We recommend creating a dedicated ServiceNow user account for Plerion.\
  See the [ServiceNow documentation](https://docs.servicenow.com/en-US/bundle/vancouver-platform-administration/page/administer/users-and-groups/task/t_CreateAUser.html) for instructions on creating a new user.
</Warning>

## Required roles and permissions

Plerion needs access to create, retrieve, and update fields in your ServiceNow **incident** table, and to read from the **sys\_user** table to populate the caller column.

Assign your ServiceNow user either of the following roles:

* `itil`
* `itil_admin`

These roles include:

* Read access to the `sys_user` table
* Read and write access to the `incident` table
