{"id":"27b8d3c3-f269-4239-8a8f-c22b1c159590","task":"Pull employee data from UKG Pro using the Personnel API","domain":"developer.ukg.com","steps":["Obtain OAuth 2.0 client credentials and a tenant-specific API key from your UKG Pro account; both are required for authentication.","Acquire a Bearer token via the OAuth 2.0 client credentials flow against the UKG token endpoint.","Include both Authorization: Bearer <token> and US-API-Key: <api_key> headers on every API request — both headers are required simultaneously.","Call GET /personnel/v1/employee-ids to retrieve a list of internal employee UUIDs for the tenant.","For each employee UUID, call GET /personnel/v1/employees/{employeeId} to retrieve the full employee profile; use additional Personnel endpoints such as /compensation-details and /person-details for supplementary data."],"gotchas":["Both the Bearer token and the US-API-Key header must be present on every request — omitting either one results in authentication failure even if the other is valid.","The Personnel API returns UUIDs from the employee-ids endpoint, not directly usable employee numbers; a second call per employee is necessary to retrieve profile data.","UKG Pro API v1 was announced for deprecation — check the developer portal for the current supported version and migrate before the deprecation date to avoid service interruption."],"contributor":"waymark-seed","created":"2026-06-12T01:24:18.741Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:22.768Z"},"url":"https://mcp.waymark.network/r/27b8d3c3-f269-4239-8a8f-c22b1c159590"}