UKG Dimensions MCP connector

• List List all UKG Dimensions current user info Get the person this connection signs in as (the API user). Returns one record with employeeId, personNumber, userName, firstName, lastName, middleInitial, timeZone and userLocale. Set include_contact_information=true to add emailContacts, telephoneContacts and postalAddresses. Truto uses this call to validate the connection. Access Control Point: CURRENT_USER_INFORMATION_READ.
• List List all UKG Dimensions persons List every person as a lightweight record: personId, personNumber, firstName, lastName, employmentStatus and userAccountStatus. Optional filters go in the body where object (employmentStatus, userAccountStatus, snapshotDate, dateRange, returnPersonIdOnly); the default where: {} returns everyone. Truto pages this for you: pass limit and next_cursor, not index or count. Pages hold up to 1,000 people (UKG allows at most 10,000 per call). For full records use persons.get, or person_extensions.list for up to 100 people at a time. Access Control Point: LIGHT_WEIGHT_EMPLOYEE_RECORDS_READ.
• Get Get single UKG Dimensions person by ID Get one person's full record by person ID (UKG's internal person key, also called the employee ID; not the person number). Returns personIdentity, personInformation (names, email addresses, phone numbers, postal addresses, employment and user account status history, custom data), jobAssignment (primary labor accounts, job assignment details, base wage rates), user (userAccount), gdapAssignments and positions.
• Update Update a UKG Dimensions person by ID Update a person by person ID (PUT /v1/commons/persons/{id}). Send the person record: personInformation is required, plus any of personIdentity, jobAssignment, user, gdapAssignments and positions. Returns the updated record. UKG returns 409 on an optimistic-locking conflict.
• Create Create a UKG Dimensions person Create a person (employee and/or user). Send the person record: personInformation is required, plus any of personIdentity, jobAssignment, user, gdapAssignments and positions. Returns the created record. UKG answers 200 (not 201) for a successful create.
• Upsert UKG Dimensions persons bulk upsert Create or update several people in one call: the body is a JSON array of person records, each with personInformation. The maximum batch size is 100; UKG notes batches of about 70 often perform better. Returns an array of the saved records. A 207 response means partial success and lists the records that failed.
• Delete Delete a UKG Dimensions person by ID Permanently delete a person record by ID (the UKG person ID, which UKG also calls employee ID; not a person number). This is a hard delete of the person and of the timekeeping, punch, accrual, schedule and request data that belongs to them; UKG documents no archive and no cascade behaviour, and answers 204 with no body. UKG allows it for inactive and terminated employees outside of the current pay period (release note WFD-154391) and rejects other people with 400. The reversible way to offboard in UKG is an effective-dated Terminated employment status.
• List List all UKG Dimensions person extensions Get full person records for specific people, grouped into extensions (employeeExtension, timekeepingExtension, schedulingExtension, accrualExtension, deviceExtension, or allExtension). Identify people in where.employees with key (personid, personnumber, jobassignmentid, username, useraccountid, badgenumber or useremailaddress) and values, and pick the extension with where.extensionType. At most 100 employees per request (People multi_* service limit). Not paginated.
• List List all UKG Dimensions base persons Get the base summary (personId, personNumber, fullName, displayName, name) for specific people. Identify them in where.employees with key (personid, personnumber, jobassignmentid, username, useraccountid, badgenumber or useremailaddress) and values. At most 100 employees per request (People multi_* service limit). Not paginated.
• List List all UKG Dimensions person external IDS Get the AOID and COID external identifiers (UKG Pro HCM / ADP IDs) of specific employees. Identify them in where.employees with key (personid, personnumber, jobassignmentid, username, useraccountid, badgenumber or useremailaddress) and values. Returns personIdentity, aoid and coid per employee. Not paginated.
• List List all UKG Dimensions person supervisors Get the supervisor ('reports to') assignments of specific employees. Identify them in where.employees with key and values. Returns personidentity, supervisorName and supervisorPersonNumber per employee. At most 100 records per request. Not paginated. Access Control Point: PE_REPORTS_TO_FIELD.
• List List all UKG Dimensions person employment terms Get the employment term assignments of specific employees. Identify them in where.employees with key and values. Returns personIdentity, assignmentSpan and assignments per employee. Not paginated.
• List List all UKG Dimensions cost centers List every cost center (id, name, description, inactive, ivrNum, persistentId, version) in one response. Not paginated. Access Control Point: COST_CENTERS.
• Search UKG Dimensions cost centers search Search cost centers with filters and sorting: where.filterCriteria (name, description, ivrNum, inactive, supportPartialStringMatch) and sortBy. Not auto-paginated: send index (0-based page number) and count in the body and request the next index until fewer than count records come back. UKG documents no upper limit for count.
• Get Get single UKG Dimensions cost center by ID Retrieve one cost center (id, name, description, inactive flag) by its ID. Access Control Point COST_CENTERS.
• List List all UKG Dimensions employee groups List employee groups (id and name only, unless all_details=true). Pass qualifier to get one group by name. Truto pages this for you: pass limit and next_cursor, not index or count. Pages hold up to 100 groups (the UKG default page size). Access Control Point: EMPLOYEE_GROUP.
• List List all UKG Dimensions symbolic periods List every symbolic period (id and qualifier), such as Current_Payperiod or Previous_Payperiod. Use them as symbolic period references in timecard, schedule and data requests. Not paginated.
• List List all UKG Dimensions pay periods Get one pay period timespan. With no parameters it returns the current pay period of the API user. Otherwise pass pay_period_id, pay_rule_id or employee_id (optionally with date), plus period_type (Previous, Current or Next). Returns one record with spanStartDate, spanEndDate, spanStartDateTime and spanEndDateTime.
• List List all UKG Dimensions locations List the organizational map locations below a location during a date span (POST /v2/commons/locations/multi_read). Send where.descendantsOfDuring with context (ORG or FORECAST), locationRef, startDate and endDate, plus optional multiReadOptions (includeOrgPathDetails, excludeExpiredNodes, modifiedSince). Truto pages this for you: pass limit and next_cursor, not index or count. Pages hold up to 100 locations.
• Get Get single UKG Dimensions location by ID Get one organizational map location (node) by nodeId. The context (ORG or FORECAST) and date query parameters are required.
• Search UKG Dimensions locations search Find organizational map locations (POST /v1/commons/locations/multi_read). Put one criterion in where: descendantsOf, childrenOf, ancestorsOf, parentOf (or their ...During forms), locationSet, locationsSpan or query (search by name). multiReadOptions can add includeOrgPathDetails, modifiedSince or excludeExpiredNodes. Returns every match in one response; not paginated.
• List List all UKG Dimensions jobs Get generic jobs by date or reference (POST /v1/commons/jobs/multi_read). Put one criterion in where: forDate (all jobs effective on a date), allJobsBySpan (a date span) or span (specific job references). multiReadOptions.modifiedSince returns only jobs changed since then. At most 5,000 jobs per request (Business Structure service limit). Not paginated.
• Get Get single UKG Dimensions job by ID Get one effective generic job by job ID. The date query parameter (YYYY-MM-DD) is required.
• List List all UKG Dimensions location sets List location sets (organizational map groups). Filter with qualifier, date and context (ORG or FORECAST); all_details=true returns full records. Truto pages this for you: pass limit and next_cursor, not index or count. Pages hold up to 100 location sets (the UKG default).
• Search UKG Dimensions location sets search Find location sets by identifier or by a name query (POST /v2/commons/location_sets/multi_read). Send where with context, date, and either locationSets or query; types accepts ids 1 (all organizational groups), 2 (manager groups) or 3 (transfer groups). Not auto-paginated: send index (0-based page number) and count in the body and request the next index until fewer than count records come back. Access Control Point: OJS_EDITOR (VIEW).
• List List all UKG Dimensions labor categories List labor categories. Pass name to get one category, or modified_since (an ISO local date-time such as 2026-01-31T00:00:00.000) to get only categories changed since then. Not paginated. Access Control Point: LABOR_CATEGORY.
• Get Get single UKG Dimensions labor category by ID Retrieve one labor category (id, name, abbreviation, sort order, inactive flag) by its ID. Access Control Point LABOR_CATEGORY.
• List List all UKG Dimensions labor entries List every labor category entry of one labor category. The categoryId query parameter is required. Not paginated. Access Control Point: LABOR_CATEGORY.
• Search UKG Dimensions labor entries search Search labor category entries with filters and sorting: where.laborCategory, where.filterCriteria (name, description, ivrNum, inactive, supportPartialStringMatch) and sortBy. Not auto-paginated: send index (0-based page number) and count in the body and request the next index until fewer than count records come back.
• Get Get single UKG Dimensions labor entry by ID Retrieve one labor category entry (id, name, description, inactive flag, labor category) by its ID. Access Control Point LABOR_CATEGORY.
• List List all UKG Dimensions hyperfinds List the Hyperfind queries (saved people searches) visible to the API user. usage_type filters to Regular, Home or All; all_details=true adds constraints. Use a Hyperfind id to scope timecard, schedule and data requests. Not paginated.
• Get Get single UKG Dimensions hyperfind by ID Get one Hyperfind query by ID. all_details=true adds constraints.
• Execute UKG Dimensions hyperfinds execute Run a Hyperfind query for a date range and get the people it selects. Send hyperfind (id or qualifier) and dateRange (startDate and endDate, or symbolicPeriod). Returns count and result (refs and basePersons). threshold caps the number of employees returned (default 3,500, up to 50,000). With enablePagination=true, send the returned nextReadToken as pageToken to get the next page. Limits: at most 365 days, 10,000 employees and 10,000 locations per request.
• List List all UKG Dimensions data Run an Information Access (aggregated data) query: select Data Dictionary keys, from a view with an employeeSet (hyperfind or employees, plus dateRange) or locationSet, optional where filters, groupBy and sortBy. Returns the whole response as one item: metadata (element totals, the cache key, and errors when a data provider hit its own limit) and data (a tree whose children are the rows). To page, send index and count with options.requestTag and keep the body otherwise identical. Limits: at most 500 employees, 365 days, employees x days 10,000 and 300 locations.
• List List all UKG Dimensions data elements List every Data Dictionary element definition (key, label, categories, dataProvider, active, deprecated, properties). Use the keys in data.list queries. Not paginated.
• Search UKG Dimensions data elements search Get Data Dictionary element definitions for specific keys. The body is a JSON array of data element keys (strings). UKG does not publish a response schema for this operation.
• List List all UKG Dimensions pay codes List the pay codes available to the API user as a manager, or one pay code by id or qualifier. Not paginated. Access Control Point: PAY_CODE_NAME_LIST.
• Get Get single UKG Dimensions pay code by ID Get one pay code by ID. Only pay codes available to the API user are returned. Access Control Point: PAYCODE.
• Search UKG Dimensions pay codes search Get pay codes by reference: send where.payCodes with ids, qualifiers or refs. References that do not match a visible pay code come back as errors (207 partial success). Access Control Point: PAYCODE.
• List List all UKG Dimensions accrual codes List the accrual codes the API user can see, or one by id or qualifier. Returns id, name, shortName, typeId, typeName, hoursPerDayInSeconds, allowEdit and positionAware. Not paginated. Access Control Point: ACCRUALS_CONFIGURATION.
• Get Get single UKG Dimensions accrual code by ID Get one accrual code by ID.
• List List all UKG Dimensions accrual profiles List accrual profiles (GET /v3/timekeeping/setup/accrual_profiles), or one by id or qualifier. all_details=true returns full profiles (otherwise only ID and name); include_accrual_policies=true adds policies. Truto pages this for you: pass limit and next_cursor, not index or count. Pages hold up to 100 profiles (the UKG default). UKG publishes no response model for this v3 operation. Access Control Point: ACCRUALS_CONFIGURATION.
• List List all UKG Dimensions work rules List the work rules available to the API user as a manager, or one by id or qualifier. Not paginated. Access Control Point: PAY_RULES.
• List List all UKG Dimensions pay rules List every timekeeping pay rule, or one by id or qualifier; all_details=false returns only IDs and names. Not paginated. Access Control Point: PAY_RULES.
• List List all UKG Dimensions timecards Get one employee's timecard as a manager. Pass employee_id or person_number, plus start_date and end_date or symbolic_period_id, and select the parts to return (such as PUNCHES, WORKED_SHIFTS, PAYCODE_EDITS, TOTALS, EXCEPTIONS); without select every part is returned. Returns one timecard record. For many employees use timecards.search.
• Search UKG Dimensions timecards search Get timecards for many employees (POST /v1/timekeeping/timecard/multi_read). Send select (at most 10 entities recommended), where.employees or where.hyperFind, and where.dateRange (dates or symbolicPeriod). partial_success=true returns 207 with per-employee results instead of failing. Limits: at most 500 employees, 365 days, and employees x days 28,000; UKG recommends at most 200 employees per pay period. Not paginated.
• List List all UKG Dimensions timecard metrics Get timecard metrics for many employees: select totals and summaries such as ACTUAL_TOTALS, SCHEDULED_TOTALS, PROJECTED_TOTALS, ACCRUAL_SUMMARY or ACCRUAL_TRANSACTIONS, with where.employeeSet (employees or hyperFindRef, plus dateRange). Returns one record per employee. Limit: employees x days at most 280,000; UKG recommends at most 200 employees per pay period. partial_success=true returns 207 instead of failing. Not paginated.
• List List all UKG Dimensions timecard approvals List timecard approvals for one employee (person_num or employee_id) over start_date and end_date, or a symbolic period. Returns employee, approvingManager, approvalDate and isEmployeeApproved per approval. Not paginated.
• List List all UKG Dimensions punches Get punches in near real time for a datetime window (POST /v1/timekeeping/punches/apply_read). Send where.dateRange (startDateTime and endDateTime) and optionally where.employees. Returns one record per employee: employee plus that employee's punches. Truto pages this for you: pass limit and next_cursor, not index or count. limit counts employees per page: at most 25 by default (a tenant system setting can allow 1 to 50).
• Import UKG Dimensions punches bulk import Import punches for many employees (such as from time clocks). Send punches (each with employee, punchDtm and optional typeOverride, orgJob, commentsNotes), plus optional options and accrualValidationRequired. Returns the saved punches; a 207 response lists the failures.
• Import UKG Dimensions pay code edits bulk import Import pay code edits (hours, days or money) in bulk. Send payCodeEdits, each with employee, paycode, applyDate and an amount (durationInHours, durationInDays or moneyAmount). Returns one result per edit (payCodeEditForRest or tkError); a 207 response lists the failures.
• List List all UKG Dimensions schedules Get the schedule of one employee, Hyperfind or location as a manager. Pass one criterion (employee_id, person_number, hyperfind_id, hyperfind_name, location_id or location_path), a date range (start_date and end_date) or symbolic period, and select (SHIFTS, PAYCODEEDITS, LEAVEEDITS, AVAILABILITIES, HOLIDAYS, and others). Returns one schedule record with shifts, payCodeEdits, leaveEdits and the other selected lists.
• Search UKG Dimensions schedules search Get schedules for many employees or locations (POST /v1/scheduling/schedule/multi_read). Send select and one where criterion: employees, hyperFind or locations, each with a dateRange. Returns one schedule object with shifts, payCodeEdits, leaveEdits and the other selected lists. Limit: employees x days at most 56,000. Not paginated.
• List List all UKG Dimensions shifts Get specific shifts by ID: send where.shiftIds (at most 500 IDs). To list shifts in a date range, use schedules.search with select SHIFTS. Returns full shift records (employee, startDateTime, endDateTime, segments). Access Control Point: SCHEDULE_ACCESS.
• Get Get single UKG Dimensions shift by ID Get one scheduled shift by ID.
• List List all UKG Dimensions schedule changes Get schedule changes for employees within an edit window (UTC). Send where.employees with employees, startDateTime and endDateTime (the edit window) and entityFilterSpan (the shift dates), plus select (SHIFTS, PAYCODEEDITS, LEAVEEDITS, DAYLOCKS, SCHEDULETAGS). Changes are compressed to the state before and after the window. Returns one snapshot per employee. At most 40 days per request. Not paginated.
• List List all UKG Dimensions time off requests Find time off requests as a manager. Put one criterion in where: employees (employeeRefs, startDate, endDate), hyperfind, ids (timeOffRequestIds) or states. Returns full requests (employee, periods, requestSubType, currentStatus). Not paginated.
• Get Get single UKG Dimensions time off request by ID Get one time off request by ID. include_overridden_shifts=true adds the overridden shifts.
• Create Create a UKG Dimensions time off request Create a time off request for an employee as a manager. Send timeOffRequest (employee, periods and requestSubType are required), plus optional skipAccrualValidation and overrideAccrualWarnings. Returns the created request.
• Update UKG Dimensions time off requests update status Move a time off request to another state as a manager (for example approve, refuse or cancel it). Body: changeState.where.timeOffRequestId and changeState.do.toStatus (a status from the request's nextValidStatuses). Returns the updated time off request.
• List List all UKG Dimensions timeoff accruals Get one employee's accrual balances as a manager: pass employee_id or person_number, and optionally date and a request subtype (subtype_id or subtype_name). Returns one record per pay code with its balances.
• List List all UKG Dimensions timeoff request subtypes List the time off request subtypes available for an employee (employee_id or person_number). Not paginated.
• List List all UKG Dimensions leave cases Find leave cases by leaveCases (IDs, at most 1,000) or by employees within a dateRange, optionally filtered by caseStatus. Limit: employees x days at most 84,000. Not paginated.
• Get Get single UKG Dimensions leave case by ID Get one leave case by ID.
• List List all UKG Dimensions leave edits Get leave edits with their paid and tracking amounts for employees (required) within a dateRange. Limits: at most 1,000 leave edits, and employees x days at most 84,000. Not paginated.
• List List all UKG Dimensions leave profiles List every leave profile, or one by name. Not paginated.
• List List all UKG Dimensions leave case statuses List the leave case statuses the tenant supports (id, qualifier, name). Access Control Point: LEAVE_CASES_FOR_MGR.
• List List all UKG Dimensions leave categories Get leave categories by reference: send ids, qualifiers or refs. Not paginated.
• List List all UKG Dimensions leave reasons Get leave reasons by reference: send ids, qualifiers or refs. Not paginated.
• List List all UKG Dimensions tenant info Get tenant information for the API user's tenant; authenticationType tells classic authentication apart from UKG Authentication. Access Control Point: REST_API_SETUP.
• List List all UKG Dimensions change indicators List the change marker types available for subscription (markerTypeId, markerName, category, cadence, retention, active). Not paginated.
• List List all UKG Dimensions change indicator markers Get change marker events (what changed, and when) for subscribed marker types. Send markers (ids or qualifiers of one cadence), startTime and endTime (the range must be a multiple of the cadence), and optional options.cadence or options.pageSize. Returns events (markerTypeId, objectId, applyDate). Truto pages this for you by following UKG's page token: pass next_cursor to continue, and do not set a page index in options.
• List List all UKG Dimensions change indicator subscriptions List change marker subscriptions: each marker type with its attributes and a subscriptions list (cadence, retention, startTime, endTime). version=all returns every version; latest is the default. Not paginated.
• List List all UKG Dimensions public hyperfinds List the public Hyperfind queries visible to the API user. all_details=true adds constraints. Not paginated.
• List List all UKG Dimensions timeoff symbolic values List the amounts (symbolic values such as a full or half day) an employee may request for a time off request subtype, per pay code. Query employee_id or person_number, and subtype_id or subtype_name.

No tools match your search.