Connect UKG Ready

Note: The UKG Ready integration is in development. General availability is planned for November 2026.

UKG Ready is an HRIS integration that syncs employee, job, and compensation data to Pave using an OAuth application you create in UKG Ready. UKG Ready is a separate product from UKG Pro. If your company uses UKG Pro, see Connect UKG Pro.

Before you connect

• You need administrator access in UKG Ready to create an OAuth application and edit security profiles.
• Pave needs read-only access. Pave only reads data from UKG Ready and never writes to it.
• You enter four values in Pave: an API URL, a Company Id, a Client Id, and a Client Secret.
• Your Company Id is a number and is different from the company name you see in UKG Ready. If you don't know it, ask your UKG representative.

Connect UKG Ready to Pave

1. In UKG Ready, go to Settings, then Global Setup, then Company Setup, then Login Config, and open the OAuth Applications tab.
   • If you don't see an OAuth Applications tab, click Edit Tabs on the Login Config page, turn on OAuth Applications, and save.
2. Add a new OAuth application for Pave using the Client Credentials grant type.
3. Generate the client secret and copy both the Client Id and Client Secret before you leave the page. UKG Ready shows the secret only once and you can't retrieve it later.
4. Give the application access to the All company employees account group.
5. Assign the application a security profile with read access to employees, positions, and compensation.
6. Collect your tenant details:
   • API URL: The address of your UKG Ready tenant, including https:// and with no trailing slash.
   • Company Id: The numeric ID for your company (at least two digits).
7. In Pave, go to Settings, then Connections, and find UKG Ready. Enter all four values and click Submit.

Troubleshooting

Connection shows an error after you submit: Pave checks your credentials as soon as you click Submit. If the check fails, the connection shows an error. Confirm that the API URL, Company Id, Client Id, and Client Secret match your UKG Ready tenant and OAuth application, then re-enter them and click Resolve.

API URL is not accepted: The API URL must start with https:// and have no trailing slash or port.

Company Id is not accepted: The Company Id must be a number with at least two digits. It is different from your company name in UKG Ready. Ask your UKG representative if you don't know it.

You lost your client secret or need to rotate it: UKG Ready doesn't let you view a secret again after you leave the page. Generate a new secret for the Pave application in OAuth Applications, then go to Settings, then Connections in Pave and enter the new secret.

After you connect

• Pave syncs UKG Ready data every hour, and each sync covers your full employee population.
• Employees who move between entities or countries in UKG Ready keep a single record in Pave.

Fields that sync

Custom mappings may apply to your account.

Employee fields

• First name, last name
• Email address
• Employee ID
• Start date
• Employment status
• Manager
• Location

Job fields

• Job title
• Department
• Job level
• Job family

Compensation fields

• Base salary
• Hourly or salaried
• Target bonus
• Variable pay
• Currency

Additional data

• Compensation history: Supported. Pave syncs past changes to base salary, variable pay, and target bonus, back to each employee's start date. Each change keeps the currency it was paid in.
• Custom fields: Supported with configuration. UKG Ready returns custom fields without labels, so Pave works with you to map them to the right fields in Pave.
• Benefits: Not supported.