UKG Ready Webhook Setup Guide

Click the ≡ (main menu) at the top-left, select the Settings category, then click Global Setup. Its submenu opens with Webhook Subscriptions listed.

Click Webhook Subscriptions. The list of existing subscriptions opens. Click New Subscription to add one.

In Available Webhooks, click the event to subscribe to. Events are grouped by category, and the events StackOne supports are listed under Available webhook events below.

Under Subscription details, enter a Name and check Active. Under Endpoint URL and Authentication, paste the StackOne Native Webhook URL into Endpoint URL.

Under Select an authentication type, choose Bearer token and paste the Webhook Auth Token into the Token field. Do NOT select No authentication — UKG Ready strips the URL query string, so the token must travel in the Authorization header or the account cannot be identified.

• Authentication type: Bearer token
• Token: the StackOne Webhook Auth Token

Under Payload Fields, tick the fields to send. Only selected fields are included, and a change to any selected field triggers the webhook. Where the event offers it, include {EMPLOYEE_IDENTIFIER} so the delivered event carries the employee id. Without it (and for events that don’t offer it, such as timesheet events) the event is identified by its UKG event id instead.

Click Save. The subscription becomes active and UKG Ready will POST matching events to the endpoint. (The Test Connection button only checks connectivity — it does not send a sample event.)

Employee record and account-level changes.

• Account Created (ACCOUNT_CREATED) — fired when a new account is added to the system
• Account Status Changed (ACCOUNT_STATUS_CHANGED) — fired when an account’s status changes
• Address Changed (ADDRESS_CHANGED) — fired when an employee’s address is changed
• Applicant Applied For Job (APPLICANT_APPLIED_FOR_JOB) — fired when an applicant applies for a job
• Base Compensation Changed (ACCOUNT_BASE_COMPENSATION_CHANGED) — fired when base compensation changes
• Contact Information Changed (CONTACT_INFORMATION_CHANGED) — fired when an employee’s contact information changes
• Cost Center Changed (COST_CENTER_CHANGED) — fired when an employee’s cost center assignment changes
• Employee Identity Changed (EMPLOYEE_IDENTITY_CHANGED) — fired when an employee’s identity attributes change
• Employment Dates Changed (EMPLOYMENT_DATES_CHANGED) — fired when an employee’s employment dates change
• HR Custom Fields Changed (HR_CUSTOM_FIELDS_CHANGED) — fired when an employee’s HR custom fields change
• Manager / Reporting Chain Changed (MANAGER_REPORTING_CHAIN_CHANGED) — fired when an employee’s manager or reporting chain changes
• National ID Changed (NATIONAL_ID_CHANGED) — fired when an employee’s national identifier changes
• Account Updated (ACCOUNT_UPDATED) — deprecated in UKG Ready; still delivered for existing subscriptions, but use the specific events above

Timesheet lifecycle.

• Submitted (TIMESHEET_SUBMITTED) — fired when an employee submits a timesheet
• Approved (TIMESHEET_APPROVED) — fired when a manager approves a timesheet
• Final Approve (TIMESHEET_FINAL_APPROVED) — fired when a timesheet is ready for payroll
• Rejected (TIMESHEET_REJECTED) — fired when a manager rejects a timesheet

Time off request lifecycle.

• Requested (TIME_OFF_REQUEST_REQUESTED) — fired when a time off request is created or its status changes
• Approved (TIME_OFF_REQUEST_APPROVED) — fired when a time off request is approved by a manager
• Changed (TIME_OFF_REQUEST_CHANGED) — fired when a time off request is modified
• Rejected (TIME_OFF_REQUEST_REJECTED) — fired when a manager rejects a time off request
• Canceled (Employee Deleted) (TIME_OFF_REQUEST_CANCELED) — fired when an employee cancels (deletes) a time off request

Timesheet change request lifecycle.

• Requested (TIMESHEET_CHANGE_REQUEST_REQUESTED) — fired when an employee requests a timesheet change
• Approved (TIMESHEET_CHANGE_REQUEST_APPROVED) — fired when a manager approves a timesheet change request
• Rejected (TIMESHEET_CHANGE_REQUEST_REJECTED) — fired when a manager rejects a timesheet change request

HR announcements and events.

• Announcement Created (HR_ANNOUNCEMENT_CREATED) — fired when an announcement is created
• Event Created (HR_EVENT_CREATED) — fired when an HR event is created

Employee schedules.

• Schedule Changed (EMPLOYEE_SCHEDULE_UPDATE) — fired when an employee’s schedule is changed or added

Open shifts and shift swaps.

• Open Shifts Posted (OPEN_SHIFTS_POSTED) — fired when open shifts are posted
• Schedule Request Peer Action (SHIFT_SWAP_ACCEPTED) — fired when a shift swap request is accepted