In ServiceNow, the RESTMessageV2 API is a scripting object used to send HTTP requests to external RESTful web services and receive responses. This API is commonly used for integrating ServiceNow with external systems and services. Here’s an overview of how to use the RESTMessageV2 object in ServiceNow:

1. Creating a REST Message Record:

   • Before using RESTMessageV2, you need to define a REST message record in ServiceNow. This record contains information about the external RESTful web service, including the endpoint URL, authentication details, request headers, and HTTP method (GET, POST, PUT, DELETE, etc.).

2. Instantiate a RESTMessageV2 Object:

   • In a server-side script (such as a Business Rule, Script Include, or UI Action), you can create a RESTMessageV2 object by instantiating it. For example:
   javascriptCopy code

   var restMessage = new sn_ws.RESTMessageV2('Example REST API', 'GET');

   • In the code above, ‘Example REST API’ is the name of the REST message record you defined, and ‘GET’ is the HTTP method you want to use.

3. Setting Request Parameters:

   • You can set various request parameters using methods like setEndpoint, setBasicAuth, setEccParameter, setRequestBody, and setQueryString. These methods allow you to configure the request URL, authentication, request headers, and query parameters.

4. Sending the Request:

   • To send the HTTP request, use the execute() method on the RESTMessageV2 object. For example:
   javascriptCopy code

   var response = restMessage.execute();

   • This method sends the request to the external RESTful service and stores the response in the response variable.

5. Handling the Response:

   • You can access the response data, status code, and headers using methods like getResponseCode, getResponseHeaders, and getResponseContent. For example:
   javascriptCopy code

   var responseCode = response.getStatusCode();
var responseBody = response.getBody();


6. Error Handling:

   • It’s important to implement error handling to handle exceptions that may occur during the request. You can use try-catch blocks to capture and handle errors.

Here’s a simplified example of how a RESTMessageV2 script might look:

This is a basic example, and you can customize it according to your specific integration requirements. The RESTMessageV2 API is a powerful tool for connecting ServiceNow with external systems, allowing you to exchange data and automate processes.