How to Access Endpoint Central Spoke Actions in Workflow Studio?

This guide provides ServiceNow administrators with step-by-step instructions for accessing and using Endpoint Central spoke actions within Workflow Studio. Learn how to automate endpoint operations including software deployment, device status monitoring, and encryption key retrieval through six powerful integration actions. Each action includes detailed input requirements, output variables, and troubleshooting guidance to help you build reliable, automated workflows.

Prerequisites

Before using Endpoint Central Spoke actions in Workflow Studio, ensure the following:

  • The Endpoint Central App is installed and activated in ServiceNow. Refer to the document to install Endpoint Central App from ServiceNow store.
  • Your ServiceNow account has the below mentioned roles to execute endpoint actions.
    • action_designer
    • flow_designer
    • flow_operator
    • x_manen_medc.DCIntegrationUser

Steps:

Follow these simple steps to view and use Endpoint Central Spoke actions in your ServiceNow Workflow Studio:

  1. Log in to your ServiceNow instance
  2. Navigate to: AllProcess AutomationWorkflow Studio
  3. Switch to the Actions tab
  4. Create a filter on the Applicationcolumn:
    • Condition: contains
    • Value: Endpoint Central
  5. The list will display all available Endpoint Central Spoke actions

Once visible, these actions can be dragged directly into your flows and sub-flows.

Slide 1 of 5
 

Endpoint Central Spoke Actions

1. Look up Device Live Status

This action checks whether a target device is currently online and reachable before executing automation tasks.

Note
All input fields are mandatory.

Inputs

FieldTypeDescription
Computer NameStringComputer name as it appears in Endpoint Central Inventory
Domain NameStringDomain name as it appears in Endpoint Central Inventory

Outputs

Output VariableTypeDescriptionPossible Values
CodeStringOperation status code0 - Success
1 - Invalid Inputs
2 - API Error
400 - API Call Failed
MessageStringBrief explanation of the resultCode 0: Success
Code 1: No device found for the provided inputs.
Code 2: Endpoint Central app internal error. Contact Endpoint Central support and share the application. logs
Code 400: API call failed with status code <code_value>. Contact Endpoint Central support and share the application logs.
Live StatusStringCurrent status of the machineOnline, Offline, Unknown, or Error
Is OnlineBooleanSimple true/false statustrue - Device is online
false - Device live status is offline, unknown, or error

2. Install Software

This action automatically installs selected software packages on target endpoints.

Note
All input fields are mandatory.

Inputs

FieldTypeDescription
Computer NameStringComputer name as it appears in Endpoint Central Inventory
Domain NameStringDomain name as it appears in Endpoint Central Inventory
Endpoint Central Software PackageList of RecordsSoftware packages from the table 'x_manen_medc_dcsoftwarepackages'
These records sync automatically via the scheduled job 'Sync Software details'
What is 'Sync Software details' scheduled job?
Using the Endpoint Central app, ServiceNow automatically synchronizes software package details from Endpoint Central on a daily schedule. Administrators can adjust the synchronization frequency based on organizational needs; however, a minimum interval of 3 hours between sync cycles is recommended.

Outputs

Output VariableTypeDescriptionPossible Values
CodeStringOperation status code0 - Success
1 - Invalid Inputs
2 - API Error
400 - API Call Failed
MessageStringBrief explanation of the result

Code 0: Success
Code 1 (one of the following):

  • No device found for the provided inputs.
  • The selected package is not available.

Code 2: Endpoint Central app internal error. Contact Endpoint Central support and share the application logs.
Code 400: API call failed with status code <code_value>. Contact Endpoint Central support and share the application logs.

Collection IDStringUnique ID created by Endpoint Central for the deploymentExample: 76297000000703059

3. Uninstall Software

This action removes selected software packages from target endpoints.

Note
All input fields are mandatory.

Inputs

FieldTypeDescription
Computer NameStringComputer name as it appears in Endpoint Central Inventory
Domain NameStringDomain name as it appears in Endpoint Central Inventory
Endpoint Central PackageList of RecordsSoftware packages from the table 'x_manen_medc_dcsoftwarepackages'
These records sync automatically via the scheduled job 'Sync Software details'

Outputs

Output VariableTypeDescriptionPossible Values
CodeStringOperation status code0 - Success
1 - Input Error
2 - API Error
400 - API Call Failed
MessageStringBrief explanation of the result

Code 0: Success
Code 1 (one of the following):

  • No device found for the provided inputs.
  • The selected package is not available.

Code 2: Endpoint Central app internal error. Contact Endpoint Central support and share the application logs.
Code 400: API call failed with status code <code_value>. Contact Endpoint Central support and share the application logs.

Collection IDStringUnique ID created by Endpoint Central for the deploymentExample: 76297000000703059

4. Look up Deployment Status

This action checks the deployment status of software installation or uninstallation tasks.

Note
All input fields are mandatory.

Inputs

FieldTypeDescription
Collection IDStringCollection ID returned from Install Software or Uninstall Software actions

Outputs

Output VariableTypeDescriptionPossible Values
CodeStringOperation status code0 - "Success" or "In Progress" or "Failed" or "Yet to Apply"
(see the table below for more details on each status)
1 - Invalid Input
2 - API Error
400 - API Call Failed
MessageStringBrief explanation of the resultCode 0: Deployment completed successfully.
Code 1: No deployment found for the specified Collection ID.
Code 2: Endpoint Central app internal error. Contact Endpoint Central support and share the application logs.
Code 400: API call failed with status code <code_value>. Contact Endpoint Central support and share the application logs.
RemarksStringAdditional details about the configuration statusThis field may be empty or contain messages such as ‘The parameter is incorrect’.
URLStringDirect link to the configuration in Endpoint Central consoleOnly available when Code is 0
Example: https://endpointcentral.manageengine.in/webclient#/uems/configuration/109832

Configuration Status Values

StatusDescription
In ProgressThe software is currently being installed or uninstalled
FailedThe installation or uninstallation process failed
Yet to ApplyThe configuration is ready and will execute during the next device refresh cycle

5. Look up Windows Encryption Key

This action retrieves the BitLocker recovery key for Windows devices.

Note
All input fields are mandatory.

Inputs

Prerequisites
  • The ServiceNow system property x_manen_medc.bitlocker must be enabled by your administrator.
  • 'Look up WIndows Encryption Key' spoke is currently limited to Windows machines only.
FieldTypeDescription
Computer NameStringComputer name as it appears in Endpoint Central Inventory
Domain NameStringDomain name as it appears in Endpoint Central Inventory
Recovery Key IdentifierStringThe key identifier displayed on the device’s BitLocker recovery screen (BSOD). This value must be provided by the end user.
It can also be obtained in Endpoint Central by navigating to BitLocker Management > Managed Computers and clicking the device name.

Outputs

Output VariableTypeDescriptionPossible Values
CodeStringOperation status code0 - Success
1 - Input Error
2 - API Error
400 - API Call Failed
MessageStringBrief explanation of the result

Code 0: Success
Code 1 (one of the following):

  • No device found for the provided inputs.
  • This action is supported only for Windows devices.
  • No encryption key available for this device.
  • ServiceNow system property x_manen_medc.bitlocker must be enabled by an administrator.

Code 2: Endpoint Central app internal error. Contact Endpoint Central support and share the application logs.
Code 400: API call failed with status code <code_value>. Contact Endpoint Central support and share the application logs.

Encryption KeysArray of ObjectsContains encryption keys for each encrypted driveJSON object with array (may be empty or contain one or more keys)

Sample JSON Object

 
{
 "Encryption Keys": [
 {
 "drive_letter": "C",
 "recover_key": "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" 
 } ] }

6. Look up Mac FileVault Key

This action retrieves the FileVault recovery key for macOS devices managed through MDM.

Note
All input fields are mandatory.

Inputs

Prerequisites

The ServiceNow system property x_manen_medc.bitlocker must be enabled by your administrator.

FieldTypeDescription
Serial NumberStringSerial number of the macOS device managed by MDM

Outputs

Output VariableTypeDescriptionPossible Values
CodeStringOperation status code0 - Success
1 - Input Error
2 - API Error
400 - API Call Failed
MessageStringBrief explanation of the resultCode 0: Success
Code 1: ServiceNow system property x_manen_medc.bitlocker must be enabled by an administrator.
Code 2: Endpoint Central app internal error. Contact Endpoint Central support and share the application logs.
Code 400: API call failed with status code <code_value>. Contact Endpoint Central support and share the application logs.
RecoveryKeyStringThe actual FileVault recovery keyFormat: A1B2-C3D4-E5F6-G7H8-I9J0-K1L2

Related Documents

Trusted by