ServiceNow Catalog Request Http Methods

Access Token HTTP Method

Add your content below this macro.

Name — Access Token
Take note of the name you use, as it is used in the Creating an Approval Business Rule script below.
HTTP method — POST
Endpoint — https://FQDN/oauth/v2/token
Replace "FQDN" with the fully qualified domain name of your EmpowerID server (e.g. sso.empoweriam.com).
On the Authentication tab, change the Authentication type to Basic. For the Basic auth profile, create a new one.
1. Click the search icon to the right of the field, and in the Basic Auth Configurations window that opens, click the New button.
2. In the dialog that appears, configure the new Basic Auth Configuration with the following settings.
  - Name — EID
  - Username — Enter your EmpowerID admin username
  - Password — Enter your EmpowerID admin password
3. Click Submit to save the profile.
4. Back on the Authentication tab, for Authentication Type, select Basic.
5. For the Basic auth profile, select the newly created EID.
On the HTTP Request tab, add two HTTP Headers.
1. In the list of HTTP Headers, double-click the text Insert a new row and enter these values.
  - Name — Content-Type
  - Value — application/json
2. Insert another new row and enter these values.
  - Name — X-EmpowerID-API-Key
  - Value — your OAuth application API key
3. Below the HTTP Query Parameters, paste the following code into the Content box. Be sure to replace FQDN with the fully qualified domain name of your EmpowerID server and the GUIDs with values from your OAuth application in EmpowerID.
```
{ 
   "client_id": "GUID from your Client ID (Key)", 
   "client_secret": "GUID from your Client Secret",
   "redirect_uri": "https://FQDN/webidpforms/oauth/v2",  
   "grant_type": "password" 
}
```
4. Click Submit to return to the main REST Message page.

Default POST HTTP Method

Add your content below this macro.

Name — Default POST
Take note of the name you use, as it is used in the Creating an Approval Business Rule script below.
HTTP method — POST
Endpoint — https://FQDN/api/services/v1/workflow/start
Replace "FQDN" with the fully qualified domain name of your EmpowerID server (e.g. sso.empoweriam.com).
On the Authentication tab, change the Authentication type to No authentication.
On the HTTP Request tab, add three HTTP Headers.
1. In the list of HTTP Headers, double-click the text Insert a new row and enter these values.
  - Name — Authorization
  - Value — Bearer ${Token}
2. Insert another new row and enter these values.
  - Name — Content-Type
  - Value — application/json
3. Insert a third row and enter these values.
  - Name — X-EmpowerID-API-Key
  - Value — your OAuth application API key
4. Below the HTTP Query Parameters, paste the following code into the Content box. Be sure to replace ServiceNow_AccountStoreID with the Account Store ID from your ServiceNow Account Store in EmpowerID and ServiceNow_OrgZoneID with the OrgZoneID of your ServiceNow location in EmpowerID.
```
{ 
    "Name": "CreateGroup",
    "TaskType":"Workflow",
    "InputParameters": 
    {
        "TargetGroup" : 
        {
            "GroupTypeID":9,
            "AllowJoinRequests":true,
            "Name":"${Name}",
            "Description":"${Description}",
            "AccountStoreID": ServiceNow_AccountStoreID
        },
        "TargetOrgZone" : {"OrgZoneID" : ServiceNow_OrgZoneID},
        "RequestInitiatedFromServiceNow" : true,
        "DecisionOfRequestInitiatedFromSN": "${Decision}"
}   
```
5. Click Submit to return to the main REST Message page.

Resume HTTP Method

Add your content below this macro.

Name — Resume
Take note of the name you use, as it is used in the Creating an Approval Business Rule script below.
HTTP method — POST
Endpoint — https://FQDN/api/services/v1/workflow/start
Replace "FQDN" with the fully qualified domain name of your EmpowerID server (e.g. sso.empoweriam.com).
On the Authentication tab, change the Authentication type to No authentication.
On the HTTP Request tab, add three HTTP Headers.
1. In the list of HTTP Headers, double-click the text Insert a new row and enter these values.
  - Name — Authorization
  - Value — Bearer ${Token}
2. Insert another new row and enter these values.
  - Name — Content-Type
  - Value — application/json
3. Insert a third row and enter these values.
  - Name — X-EmpowerID-API-Key
  - Value — your OAuth application API key
4. Below the HTTP Query Parameters, enter the following code into the Content box.
```
{
       "InstanceId": "${WorkflowInstanceID}",
       "CorrelationId": "${CorrelationId}", 
       "Name" : "CreateGroup",
       "InputParameters": {
           "Decision": "${IsApproved}"
       },
       "OutputParameters": ["*"]
}
```
5. Click Submit to return to the main REST Message page.