This guide explains how to integrate Mavenoid with ServiceNow using the REST API to manage records using Token-based Authentification.

Requirements

• Admin Access To Mavenoid: If you do not have admin permissions, please reach out to your Mavenoid representative.

• API Credentials: For Token-based Authentication, refer to ServiceNow's Configure API key - Token-based authentication guide. Ensure you are aware of the necessary API scopes required for the REST APIs you plan to use. Detailed information can be found in ServiceNow's REST API documentation.

Configure the Integration

Use the Call External API action to configure the integration.

1. Set Up Authentication: Add the API token as a secret in Mavenoid. In your API requests, include the header: x-sn-apikey: {{$secrets["YOUR_TOKEN"]}}

2. API Call Configuration: Use the ServiceNow REST API to interact with your ServiceNow instance. For example:

   • Query Contacts: To verify if a contact already exists, use the GET /now/contact endpoint. You can query contacts by specifying a unique identifier, such as the customer's email.

   • Create Contacts: To create a contact for the customer, use the POST /now/contact endpoint.

   • Create Service Cases: To create a service case for the customer, use the POST /sn_customerservice/case endpoint.