> For the complete documentation index, see [llms.txt](https://docs.balkan.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.balkan.id/getting-started/system-notifications-and-automatic-ticket-creation/supported-ticketing-systems/servicenow.md).

# ServiceNow

## Introduction <a href="#h_01hr43g9x1hnvnrxbzqa3qsdjq" id="h_01hr43g9x1hnvnrxbzqa3qsdjq"></a>

You can automatically create tickets (called as incidents) in ServiceNow as part of the following cases:

* Access Request has been approved
* Access Review has been denied

This functionality allows you to automatically create tickets to provision/de-provision resources based on the corresponding access request/review. Let us explore the steps to configure this on your tenant:

## Configure ServiceNow Email Notification System: <a href="#h_01hr43gkmbr25jr2m35kt363bz" id="h_01hr43gkmbr25jr2m35kt363bz"></a>

### Within ServiceNow <a href="#h_01hr43g4x52k5d6xfdhpz3zzk9" id="h_01hr43g4x52k5d6xfdhpz3zzk9"></a>

To enable email-based ticketing with ServiceNow, please ensure that your instance is configured to receive and process inbound emails. Follow the steps below:

1. **Enable inbound email**\
   First, confirm that inbound email is enabled in your ServiceNow instance.\
   To do this, navigate to:\
   \&#xNAN;*System Properties* **>** *Email Properties* and make sure the **“***Email receiving enabled***”** option is turned on.<br>

   <figure><img src="/files/7CPMOoa73YylqM3wJMNQ" alt=""><figcaption></figcaption></figure>
2. **Verify email receiving setup**\
   Next, ensure that your instance can successfully receive emails. To do that, go to:\
   \&#xNAN;*System Diagnostics* **>** *Email Diagnostics* and verify that **Email receiving is operational**.\
   \
   To be operational:

   * Inbound email configuration must be enabled (as per step 1).
   * Your instance must have a valid email account configured using the **POP3 protocol**.

   \
   By default, each ServiceNow instance includes its own POP3 mailbox in the format:\
   \&#xNAN;**`{instance_name}@service-now.com`**\
   \
   You can find your instance name in your ServiceNow URL:\
   For example, if your URL is **`https://acme.service-now.com/`**, your default mailbox is **`acme@service-now.com`**.\
   \
   If your instance does not have a default POP3 mailbox, please contact BalkanID support (<support@balkan.id>) — we’ll guide you through setting it up.

   <figure><img src="/files/yyahtBt5cc5ju14lBlft" alt=""><figcaption></figcaption></figure>
3. **Activate the “Create Incident” inbound action**\
   Finally, ensure that the “Create Incident” inbound action is active.\
   To check this, go to:\
   \&#xNAN;*System Policy* **>** *Email* **>** *Inbound Actions*\
   Search for **“Create Incident”** and confirm that it is marked as **Active**.

<figure><img src="/files/rirmMe0sRTIK6D10OOkp" alt=""><figcaption></figcaption></figure>

### To configure within your tenant <a href="#h_01hr43v8yte2q8z6gxgwnm345q" id="h_01hr43v8yte2q8z6gxgwnm345q"></a>

1. Go to Configure > Integrations on your BalkanID tenant.
2. Click on either *Add Integration* or *Edit Integration* for a particular integration.<br>

   <figure><img src="/files/UxzaSqCopMEUTpyhuXsy" alt=""><figcaption></figcaption></figure>

   <figure><img src="/files/Q35FCT5GVTlqO1ErWxRh" alt="" width="375"><figcaption></figcaption></figure>
3. Go to the *Optional Configuration* section.&#x20;
4. In **Fulfillment options,** choose **ticket creation**. It will open up a section below to select the ticketing system - *Servicenow* in this case. A text box will also appear to set the *Email Address*. Add the **Mailbox address** address mentioned above. Then hit *Save Changes* on the side panel. <br>

   <figure><img src="/files/YkyDaLdNM4Dx2beHihKb" alt=""><figcaption></figcaption></figure>
5. This is all the configuration you need to do on the tenant. Click on Save.

You can test your setup by denying access reviews on your tenant. After the campaign has been marked as **complete**, an email will be sent out and an incident will be created in ServiceNow.<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.balkan.id/getting-started/system-notifications-and-automatic-ticket-creation/supported-ticketing-systems/servicenow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.