Authenticate to UKG Pro Web Services and retrieve an employee's employment information via the SOAP-based Employee Employment Information Service.
domain: developer.ukg.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Obtain a UKG Pro Service Account (recommended) or a Web User account with Web Services permissions from a UKG Pro administrator.
Retrieve the Customer API key from the UKG Pro Web Service admin page and the User API key from the Service Account admin page.
Call the Authenticate operation on the Login Service (SOAP) with the account username/password to obtain an authenticationToken.
Attach the authenticationToken (ultiproToken) and Customer API key (ClientAccessKey) as SOAP headers on subsequent service calls.
Call FindEmploymentInformations with query filters (e.g. LastName, Status) and paging (PageNumber/PageSize, max 100 records per page) to search employees, or GetEmploymentInformationByEmployeeIdentifier for one employee by employee number.
Parse the returned EmploymentInformation objects for fields like EmploymentStatus, OriginalHire, and LastHire.
Known gotchas
This is a SOAP 1.2 web service, not REST — you need a WSDL-based client (e.g. a Visual Studio service reference), not plain JSON HTTP calls.
Authentication needs two separate API keys (Customer API key + User API key) in addition to account credentials — missing either breaks auth.
Search results cap at 100 records per page, so bulk reads require looping on PageNumber until PagingInfo.TotalItems is exhausted.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?