To utilize the ServiceNow sink, you must first create a personal developer instance. ServiceNow offers free Personal Developer Instances, which you can use to test incidents.

Once logged into your ServiceNow instance, you need to create a user that will be used in the sink to create incidents. To do this, navigate to the dashboard and in the search bar, enter "users." Under either Users and Groups or User Administration, click on Users.

Clicking on the Users tab will display a list of all users, where you can add new users by clicking the New button in the top right corner. For detailed instructions, refer to the Add user docs.

First, create a new user and then set the password. Generate a new password and store it for later use.

Ensure the user has the snc_platform_rest_api_acccess set. To set the user role, click the Roles tab in the user details view.

The required fields are short_description, which will be set through the event, and caller_id, which will be set in the configuration. caller_id represents the user who created the configuration, and you can set this to the User ID from the user form.

Incidents will be created using event fields.

Example:

{
  "caller_id": "user123",
  "comments": "Additional comments here",
  "category": "IT",
  "correlation_display": "Alert Label",
  "correlation_id": "correlation123",
  "description": "Description of the incident",
  "impact": "1",
  "severity": "2",
  "short_description": "ServiceNow Incident",
  "subcategory": "Software",
  "urgency": "1"
}

To find incidents on ServiceNow platform, open the dashboard and search for incident. Click on All under Incident.

In the list of Incidents, filter incidents based on Caller & enter the User you created or order by latest.

Now you're ready to configure your Sink in Onum.