---
sourceDocument: Australia Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# UKG Spoke

# UKG Spoke {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes to read

Manage time off requests in UKG from your ServiceNow instance.

## Request apps on the Store {#kronos-spoke__section_dyr_bm5_y3b}

Visit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).{#kronos-spoke__inline-send-to-store}

## Integration Hub subscription {#kronos-spoke__section_rsf_yvb_l3b}

This spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).

## Spoke version {#kronos-spoke__section_ujk_1dy_bsb}

UKG spoke v3.6.1 is the latest version.{#kronos-spoke__ukgspk-ver}

## Supported versions {#kronos-spoke__section_zjt_sh4_zgb}

This spoke was built for UKG version v1, but may be compatible with later versions.

## Spoke dependencies {#kronos-spoke__section_f33_14p_tlb}

If you're having trouble installing the app, ensure that these
dependent plugins are installed:

* Complex Object (com.glide.cobject)
* ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
* ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
* ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
* ServiceNow IntegrationHub Action Template - Data Stream (com.glide.hub.action_type.datastream)

{#kronos-spoke__ul_u5k_czb_glb}  
Note:  
Some of these plugins are licensable features and require an appropriate license if used outside the spoke implementation. For information on licenses, contact your account manager.

## Spoke flows {#kronos-spoke__section_u5m_tgf_kfb}

The UKG spoke provides sample flows to demonstrate automating the UKG tasks. To customize a sample flow, copy it to a new application scope. Available sample flows include:{#kronos-spoke__table_c3c_zj4_5lb__entry__2}

| Flow | Description |
|-|-|
| Kronos - Create Manager Time Off Request | Creates the time of request for a manager or employee. |
| Kronos - Get New Refresh And Access Token | Retrieves access token for UKG and generates a new refresh token periodically. |
| Kronos - Refresh The Access Token | Refreshes the access token for UKG. |
| Kronos - Retrieve And Update Manager Time Off Request Status | Retrieves status of the time off request status and updates the details of the associated request item. |
| Kronos - Time Off Details House Keeping | Deletes the time off requests based on the provided criteria. By default, the flow deletes time off requests that have been approved 7 days ago. |
[ ]

{#kronos-spoke__table_c3c_zj4_5lb}

Every flow triggers an associated subflow.

## Spoke subflows {#kronos-spoke__section_uxx_tgf_kfb}

The UKG spoke provides sample subflows to demonstrate automating Kronos tasks. To customize a sample subflow, copy it to a new application scope. Available sample subflows include:  
{#kronos-spoke__table_hbd_qty_qfb__entry__2}

| Subflow | Description |
|-|-|
| Kronos - Get Kronos Token | Uses the details provided during spoke setup to retrieve a valid refresh token from UKG. |
| Kronos - Create Manager Time Off Request | Creates the time off request and saves the information in your ServiceNow instance. |
| Kronos - Manager Time Off Request | Creates the time off request for a manager or employee. |
| Kronos - Retrieve Manager Time Off Request Status Update | Retrieves status of the time off request status and updates the details of the associated request item. |
| Kronos - Time Off Request Housekeeping | Deletes the time off requests based on the provided criteria. By default, the subflow deletes time off requests that have been approved 7 days ago. |
| Kronos - Report Missed Punches as Employee | This subflow creates a task which allows the employee's manager to punch the employee's missing entry. |
[ ]

{#kronos-spoke__table_hbd_qty_qfb}

## Spoke actions {#kronos-spoke__section_b43_3h2_hfb}

The UKG spoke provides actions to automate UKG tasks when events occurs in ServiceNow. Available actions include:  
{#kronos-spoke__table_hly_xfm_5lb__entry__3}

| Category | Action | Description |
|-|-|-|
| Authentication Management | Get Kronos Refresh Token | Retrieves the Refresh Token for UKG. |
| Authentication Management | Get Kronos Token | Retrieves the Token for UKG. |
| Persons | Create Persons | Creates records for one or more persons. |
| Persons | Retrieve Person by ID | Retrieves the details of a person for the specified record ID. |
| Persons | Retrieve Persons | Retries the record details of a list of persons based on the search criteria. |
| Persons | Update Persons | Updates the records of one or more persons. |
| Scheduling | Retrieve Manager Schedule | Retrieves the schedule of a list of employees. |
| Default | Add Timestamp | Adds or records a timestamp for a punch transaction of an employee. |
| Default | Approve Timecard Employee | Approves the employee timecard for the specified range of dates. |
| Default | Approve Timecard Manager | Adds manager approval for the specified employee's timecard. |
| Default | Look up Shift Cover Requests as Manager | Retrieves one or more shift cover requests matching specified search criteria. |
| Default | Look up Open Shifts Requests Manager | Retrieves a list of Open Shift Requests based on the Employee ID or Person Number. |
| Default | Look up Self Schedule Requests Manager | Retrieves a list of Self Schedule requests based on the Employee ID or Person Number. |
| Default | Look up Shift Swap Requests Manager | Retrieves a list of swap requests based on the Employee ID or Person Number. |
| Default | Look up Manager Availability Requests | Retrieves all availability requests for the given criteria. |
| Default | Retrieve Employee Timecard Request | Retrieves the timecard details of the specified employee. |
| Default | Retrieve Employee Timecards Request | Retrieves the details of a list of timecards for the specified employees or for the specified Hyperfind details. |
| Default | Retrieve Manager Timecard | Retrieves the timecard of the specified manager. |
| Default | Retrieve Manager Timecards | Retrieves the details of a list of timecards for the specified mangers or the specified Hyperfind details. |
| Default | Retrieve Timecard Approvals Employee | Retrieves a list of employee timecard approvals for the specified date range. |
| Default | Retrieve Timecard Approvals Manager | Returns a list of manager timecard approvals for the specified date range. |
| Default | Update Timecard | Updates the timecard of the specified employee. |
| Metadata Retrieval | Get Accrual Codes | Retrieves a list of accrual code types according to the user's access rights. |
| Metadata Retrieval | Look Up Cost Centers | Retrieves a list of available cost centers. |
| Metadata Retrieval | Look Up Jobs | Retrieves a list of available jobs. |
| Metadata Retrieval | Look Up Labor Categories | Retrieves a list of available categories. |
| Metadata Retrieval | Look Up Labor Category Entries | Retrieves a list of available labor category entries. |
| Metadata Retrieval | Look Up Work Rules | Retrieves a list of available work rules. |
| Metadata Retrieval | Retrieve Hyperfind Queries | Retrieves a list of Hyperfind queries. |
| Metadata Retrieval | Retrieve Licenses | Retrieves a list of licenses. |
| Metadata Retrieval | Retrieve Pay Rules | Retrieves a list of pay rules. |
| Metadata Retrieval | Retrieve Symbolic Period ID | Retrieves the specified symbolic period. |
| Metadata Retrieval | Retrieve All Pay Codes | Retrieves all the play code in UKG. |
| Metadata Retrieval | Retrieve Employee Request Subtype | Retrieves a list of request subtypes associated with the required Person Number. |
| Metadata Retrieval | Retrieve Manager Request Subtype By Employee ID | Retrieves a list of request subtypes associated with the required Employee ID. |
| Metadata Retrieval | Retrieve Manager Request Subtype By Person Number | Retrieves a list of request subtypes associated with the required Person Number. The action output is necessary for subsequent actions such as, the Retrieve Employee Accrual Balance action from manager's perspective. |
| Metadata Retrieval | Retrieve Manager Symbolic Amount Qualifiers By Employee ID | Retrieves different types of Retrieve Manager Symbolic Amount Qualifiers By Employee ID, such as half day, full day, and so on, based on Employee ID. |
| Metadata Retrieval | Retrieve Manager Symbolic Amount Qualifiers By Person Number | Retrieves different types of Retrieve Manager Symbolic Amount Qualifiers By Employee ID, such as half day, full day, and so on, based on Person Number. |
| Metadata Retrieval | Retrieve Symbolic Periods | Retrieves all the symbolic periods. |
| Scheduling Management | Create Employee Time Off Request | Creates a time off request based on the provided inputs. |
| Scheduling Management | Create Manager Time Off Requests | Creates a time off request based on the provided inputs. |
| Scheduling Management | Look up Employee Schedule | Retrieves the schedule of the employee. |
| Scheduling Management | Retrieve Employee Accrual Balance | Retrieves details of the different types of employee accrual balance, such as PTO, sick days, and so on. |
| Scheduling Management | Retrieve Employee Time Off Requests | Retrieves details of the time off requests based on the specified search criteria. |
| Scheduling Management | Retrieve Manager Accrual Balance By Employee ID | Retrieves details of the different types of manager accrual balance using Employee ID. |
| Scheduling Management | Retrieve Manager Accrual Balance By Person Number | Retrieves details of the different types of manager accrual balance using Person Number. |
| Scheduling Management | Retrieve Manager Time Off Requests By Employee ID | Retrieves details of the time off requests based on the specified search criteria and Employee ID. |
| Scheduling Management | Retrieve Manager Time Off Requests By Person Number | Retrieves details of the time off requests based on the specified search criteria and Person Number. |
| Scheduling Management | Update Employee TimeOff Request | Updates the state of an employee time off request. |
| Scheduling Management | Update Manager Time Off Requests | Updates the state of a manager time off request. |
| Timekeeping | Get Employee Accruals by Person Number | Retrieves different types of employee accrual balances. |
| Timekeeping | Retrieve Timecard Approvals Manager | Retrieves a list of timecard approvals within the specified date range. |
[ ]

{#kronos-spoke__table_hly_xfm_5lb}

## Spoke module {#kronos-spoke__section_e5y_ndt_tlb}

The UKG spoke adds a UKG application to your ServiceNow instance. The UKG application has these modules.{#kronos-spoke__table_qbq_m4n_5lb__entry__2}

| Module | Description |
|-|-|
| Credentials | Details of the UKG users with permissions to perform the required actions. |
| Time Off Request Details | Details of the time off requests, along with the status. |
| Time Off Request Details Staging Tables | Details of the time off requests from the staging tables. |
[ ]

{#kronos-spoke__table_qbq_m4n_5lb}

## UKG spoke account requirements {#kronos-spoke__section_rh3_lj2_hfb}

The UKG spoke requires registering an OAuth 2.0 application in your UKG account to generate OAuth 2.0 tokens for the UKG spoke. Record the generated Client ID, Client Secret, and Application key for later
use.

## Connection and credential alias requirements {#kronos-spoke__section_ibn_pj2_hfb}

Integration Hub uses aliases to manage connection
and credential information. Using an alias eliminates the need to configure multiple
credentials and connection information profiles when using multiple environments. If the
connection or credential information changes, you don't need to update any actions that
use the connection. For more information, see [Connections and Credentials](https://www.servicenow.com/docs/access?context=r-credentials&version=australia&pubname=australia-platform-security&ft:locale=en-US).

For information about setting up the spoke, see
.