Create People Finder Spoke

A spoke is a scoped application containing Flow Designer content dedicated to a particular application or record type. This includes integrations that connect external systems or services with the ServiceNow platform. By leveraging spokes, organizations can extend the capabilities of their ServiceNow instance and integrate it with a wide range of external tools and services, enhancing automation, collaboration, and efficiency across their IT operations and business processes.

Click here to learn more about Spokes.

Spoke Generator allows users to create custom spokes for integrating ServiceNow with external systems or services. It provides a graphical interface and a set of tools to streamline the process of building, configuring, and deploying spokes tailored to specific integration scenarios.

Click here to learn more about Spoke Generator.

We will create a re-usble integration to the finance department's People Finder Open API, so that we can access this data in our Main flow.

Open Flow Designer to use Spoke Generator to create the People Finder Integration

Go to the tab with the ServiceNow Admin Home Page (your title may be different).
Open Flow Desginer from the All Menu
1. Click the All menu
1. Search for "flow designer"
1. Click on: Process Automation > Flow Designer
Create New Spoke
1. Click Create new ▼
1. Click "Spoke"

Setup General Information for the Spoke (💡 double-click to select, copy & paste into the form).

	Field Name	Field Value
➊	Drag and drop the icon in the telework_lab files folder we downloaded earlier	people_finder.png
➋	Spoke Name (App scope name will auto-populate)	People Finder
➌	Description	API to find people in a remote system
➍	Click on the Create and continue button.

Specify how we want to build our Spoke
1. Select OpenAPI Specification
1. Click Continue
For the OpenAPI source, click Import new
Fill the user form with the following values (💡 double-click to select, copy & paste into the form).
Field Name Field Value
➊ Import method Import from URL
➋ OpenAPI URL https://low-code.guide/api-specs.json
➌ Click on the Import button.
For the Connection alias, click Create new
Fill the user form with the following values (💡 double-click to select, copy & paste into the form).
Field Name Field Value
➊ Connection alias name People Finder
➋ Authentication Configuration Template API Key Template
➌ Click on the Create button.
To continue, click the Generate operations button
Select the actions you want to create
1. Select all actions
1. Click the Publish(1) | ▼ button
Click the "GET /user" link to view the action we just created
Before we can test and use our spoke, we need to set the Base URL for the Connection.
Click to expand the OpenAPI step
Click the plus sign next to the Connection Alias
Set up the HTTPs(s) Connection (💡 double-click to select, copy & paste into the form).
Field Name Field Value
➊ Name People Finder
➋ Connection alias x_snc_people_finde.People_Finder
➌ Connection URL https://low-code.guide/api
➍ Click on the Submit button.
The Base URL should now be populated.
Click on the Test button
Test the action with David Loo's email (💡 double-click to select, copy & paste into the form).
Field Name Field Value
➊ email david.loo@example.com
➋ Click on the Run Test button.
When the test completes, click the link to view the execution results
Click on the RUNTIME VALUE link
Review the JSON results. We can switch to the Formatted view.
Click Formatted toggle.
Expand the output.
Review the Formatted JSON results.
1. Note the telework-certified value.
1. Click Close
Close the Execution Details tab
Close the Test Action model by clicking the Cancel button
Save the GET /user spoke action
Click the Save button
Now, we publish the spoke, so it will be available to call from our Main Flow.
Click the Publish button
Confirm publication of the action
Click the Publish button