Understanding IntegrationHub REST Spokes and Webhooks

IntegrationHub enables developers to connect ServiceNow workflows with external SaaS applications like Jira, Salesforce, Slack, and AWS without writing custom integration code from scratch. This article covers building custom REST Spokes using Flow Designer Action Builder.

Key Components of a Custom Spoke

• Connection & Credentials: Secure storage of OAuth 2.0 client IDs, API keys, or Basic Auth profiles.
• REST Step: Defines endpoint URL, HTTP method (GET, POST, PUT, DELETE), headers, and query parameters.
• Script Step: JavaScript step for parsing JSON payloads, handling error codes, and formatting outputs.

// Action Builder Script Step Sample
(function execute(inputs, outputs) {
    var responseBody = JSON.parse(inputs.response_raw);
    if (inputs.status_code === 200) {
        outputs.ticket_id = responseBody.id;
        outputs.status = "SUCCESS";
    } else {
        outputs.status = "ERROR: " + inputs.status_code;
    }
})(inputs, outputs);