Skip to main content

​
Overview

Alex integrates with UKG Pro Recruiting through Kombo, our unified integration provider. A single connection covers both directions:
  • Jobs and applications sync into Alex. New job requisitions in UKG Pro automatically appear in Alex, where your job workflow configures them into interviews; new applications enter your application workflow (for example, automatically inviting each applicant to an interview).
  • Interview results sync back to UKG Pro. Your workflows can move applications between pipeline stages, post notes, upload the Alex interview report as an attachment, and add a link to the Alex report on the candidate’s record.

​
Key Features

​
Automated Job Import

When a job requisition is created in UKG Pro, Alex imports it and runs your job workflow — generating an interview template from the job’s title and description. Use the New Job from ATS trigger node in your job workflow to configure which UKG Pro fields (including custom fields) populate the job title, description, and jobs-list columns, and use Filter by Job nodes to route different kinds of jobs to different interview templates. Filter by Job includes two UKG-specific fields alongside the standard ones:
  • Pay Type — Hourly or Salary, derived from the requisition’s pay period, so you can route hourly and salaried roles differently without reasoning about individual pay periods.
  • Visibility — Public (posted to your external careers site) or Unlisted (open but not externally posted).

​
Manual Job Import

You can also import a single job on demand: when creating a job in Alex, choose Import from ATS and paste the UKG Pro requisition ID. This option appears once the Kombo connection has finished its first sync.

​
Automated Interview Invites

When a candidate applies in UKG Pro, Alex picks up the application, creates the candidate, and fires the New Application trigger in your application workflow — typically inviting the candidate to an interview by email or SMS.

​
Write-Backs to UKG Pro

Workflow action nodes let Alex update UKG Pro as candidates progress: Filter by Application and Filter by Job nodes can branch on any standard or custom UKG Pro field, so write-backs run only when your conditions match.
UKG Pro supports notes and attachments at the application level only — there is no candidate-level note or attachment. To surface Alex results on the candidate record itself, use Add Alex Report Link.

​
Step 1: Connect UKG Pro via Kombo

  1. In Alex, go to Settings → Integrations and select UKG Pro.
  2. Click Connect. A Kombo-hosted connection page opens in a new tab with step-by-step instructions for each credential it asks for.
  3. Tenant alias — log into UKG Pro, search for Recruiting Gateway, and paste your recruiting dashboard’s URL into the connection flow.
  4. OAuth client ID and secret — these can only be issued by UKG. The connection flow generates the exact API scopes to request and provides a ready-to-send message for UKG support (or your UKG success manager). Send it, and return to the connection flow to enter the client ID and secret once UKG replies.
  5. Back in Alex, the UKG Pro card shows Syncing… while Kombo runs its first sync, then Connected. Job and application sync begins automatically once the first sync completes.
Because the OAuth credentials come from UKG support, connecting usually spans two sittings: start the flow and request the credentials, then finish it once UKG replies. If the card shows Needs attention, the connection requires re-authorization — repeat the Connect flow or contact your Alex account team.

​
Step 2: Configure Your Workflows

  • Job workflow — add the New Job from ATS trigger. Its editor lets you choose which UKG Pro fields populate the job title, description, client name, and location columns, and which jobs to import (e.g. only Public requisitions, or only Hourly roles).
  • Application workflow — add the New Application trigger as the entry point. Every new UKG Pro application enters the workflow here.
  • Write-backs — add the UKG Pro action nodes (stage move, note, attachment, report link) wherever your workflow should update UKG Pro, e.g. after an interview completes or a decision is made.

​
Sync Behavior

  • Jobs and applications are polled every few minutes from Kombo’s synced copy of your UKG Pro data, so a brand-new requisition or application typically appears in Alex within minutes.
  • A requisition posted to multiple job boards can surface as several posting variants in the sync feed; Alex collapses these to a single job automatically.
  • Alex stores UKG Pro’s own identifiers, so a job imported manually and the same job arriving via auto-import deduplicate to a single record.
  • Stage names in the Update Application Stage dropdown come from your open jobs’ pipelines; the stage must exist on the application’s job for the move to succeed.

​
Stage-move limitations

UKG Pro enforces two rules on stage transitions, and Alex surfaces them as clear errors rather than raw API failures:
  • An application cannot be moved to a Rejected or Declined stage via the stage-move action — rejection is a separate action in UKG Pro. Alex blocks a move to a stage whose name indicates rejection before it is attempted.
  • An application cannot be moved back to the initial step of its pipeline.

​
Troubleshooting