Overview
This article catalogs the error messages within the UKG Pro integration, grouped by the flow that produces them. Use it to identify an error seen in iPaaS.com under Dashboard / Integration Monitoring / Error Logs, understand what caused it, and resolve it.
Some integration behaviors produce no error at all — for example, an employee filtered out by employment status is skipped silently rather than failing. Those behaviors are described in the UKG Pro Integration Known Limitations article and in each mapping collection's description, not here.
Supported Flows
Connection and Authentication
Add/Update UKG Pro Employee TO iPaaS.com
Add/Update UKG Pro Employee Address TO iPaaS.com
Connection and Authentication
Connection validation failed
Unable to validate the UKG Pro connection.
Description: The integration validates its UKG Pro connection before transferring by requesting the tenant's company details. This message appears when that request neither succeeded nor returned a message the integration could report — most often a network path problem, or a tenant host that responds but not with the expected company data.
Resolution: Confirm the API Url on the iPaaS.com Subscription Settings page is the tenant's UKG Pro service host, in the form
https://{hostname}.ultipro.com, and that it is reachable from outside your network. Confirm the tenant is available in UKG Pro. If the URL is correct and UKG Pro is available, contact iPaaS.com Support at support@ipaas.com.
UKG Pro rejected the connection
The message returned by UKG Pro is reported as-is.
Description: UKG Pro rejected the validation request and returned a reason. This is most often an authentication failure — wrong user name or password, a disabled service account, an incorrect customer API key — or a permissions failure where the service account lacks access to a web service the integration reads. Because the text originates in UKG Pro, it cannot be changed by iPaaS.com.
Resolution: Confirm the API Key, API Username, and API Password values on the Subscription Settings page. Then confirm in UKG Pro under System Configuration > Security > Service Account Administration that the service account is active and retains View access to the Employee Person Details, Employee Employment Details, Compensation Details, Platform Configuration Fields, and Company Details web services. UKG Pro displays a service account password only once, so a lost password must be regenerated in UKG Pro and re-entered in iPaaS.com. If the credentials are correct and the message persists, contact iPaaS.com Support at support@ipaas.com.
Add/Update UKG Pro Employee TO iPaaS.com
Too many requests
Received a Too Many Requests response from UKG Pro. There is no indication when more requests might be accepted.
Description: UKG Pro rejected a request because too many calls were made in a short period. UKG Pro does not indicate when capacity will return, so the integration cannot schedule a precise retry and stops the affected transfer. The message is reproduced above exactly as the integration emits it, so it can be searched for in the error log.
Resolution: No action is required — the affected employees are captured on the next scheduled poll. If the message recurs consistently, lower the API Throttle Limit or raise the API Throttle Seconds value on the Subscription Settings page so the integration paces its calls more conservatively, and reduce Concurrent Connections if several transfers run at once. If throttling continues at conservative settings, raise the pattern with UKG.
UKG Pro request failed
The message returned by UKG Pro is reported as-is.
Description: A request for person, employment, compensation, or configuration-field data failed and UKG Pro returned a reason. Common causes are a service account that has lost access to one of those web services, a UKG Pro maintenance window, or a transient network failure. Because the text originates in UKG Pro, it cannot be changed by iPaaS.com.
Resolution: If the message indicates a permissions problem, confirm the service account's web service access in UKG Pro as described under UKG Pro rejected the connection above. Otherwise treat it as transient — the employee is re-captured on the next scheduled poll, or immediately by running a Manual Sync. If failures continue beyond a short window, contact iPaaS.com Support at support@ipaas.com.
Add/Update UKG Pro Employee Address TO iPaaS.com
No errors specific to this flow
Description: The Employee Address collection runs as part of its parent employee transfer and makes no separate calls to UKG Pro, so it produces no error messages of its own. When an address fails to arrive, the cause is a failure in the parent employee transfer, and the error is reported against that flow above.
Resolution: Resolve the parent employee error listed under Add/Update UKG Pro Employee TO iPaaS.com. Once the employee transfers successfully, its address is captured with it.