> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# UKG Pro HCM Recruitment & Onboarding

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List all open job opportunities and show how many applications each has received.
* Find candidates in the final interview stage who haven't received an offer yet.
* Pull all new hires currently in onboarding and check their completion status.

## Available Tools

#### list_applications

List candidate applications in UKG Pro Recruiting with pagination. Returns application status, candidate, and job details

#### get_application

Get a single application by ID from UKG Pro Recruiting. Use list_applications to find valid application IDs

#### create_application

Submit a candidate application for a job opportunity in UKG Pro Recruiting. Requires candidate_id and opportunity_id

#### update_application

Update the status or stage of an application in UKG Pro Recruiting. Use list_applications to find valid application IDs

#### list_candidates

List candidates in UKG Pro Recruiting with pagination. Returns candidate profiles including names and contact info

#### get_candidate

Get a single candidate by ID from UKG Pro Recruiting. Use list_candidates to find valid candidate IDs

#### lookup_candidate

Look up a candidate by email address in UKG Pro Recruiting. Returns the candidate ID if a match is found

#### create_candidate

Create a new candidate in UKG Pro Recruiting. Requires first_name, last_name, and email

#### update_candidate

Update an existing candidate's profile in UKG Pro Recruiting. Use list_candidates or lookup_candidate to find IDs

#### list_offers

List job offers in UKG Pro Recruiting with pagination. Returns offer status and associated application details

#### get_offer

Get a single job offer by ID from UKG Pro Recruiting. Use list_offers to find valid offer IDs

#### create_offer

Create a job offer for an applicant in UKG Pro Recruiting. Requires an application_id

#### update_offer

Update a job offer in UKG Pro Recruiting (e.g. accept, decline, or rescind). Use list_offers to find the offer ID

#### list_new_hires_in_progress

List new hires currently in progress in UKG Pro Onboarding. Returns new hire IDs, names, hire dates, and onboarding status

#### list_new_hires_completed

List completed new hires in UKG Pro Onboarding. Returns new hire records that have finished the onboarding process

#### get_new_hire

Get a single new hire record by ID from UKG Pro Onboarding. Returns full onboarding details including job and company info

#### create_new_hire

Create a new hire record in UKG Pro Onboarding to start the onboarding process. Requires first_name, last_name, and hire date

#### delete_new_hire

Delete (cancel) a new hire record in UKG Pro Onboarding. This cancels the onboarding process for the new hire

#### list_opportunities

List job opportunities (open requisitions) in UKG Pro Recruiting with pagination. Supports filtering by updated date

#### get_opportunity

Get a single job opportunity by ID from UKG Pro Recruiting. Use list_opportunities to find valid opportunity IDs

#### create_opportunity

Create a new job opportunity (job posting/requisition) in UKG Pro Recruiting. Requires a title

#### update_opportunity

Update an existing job opportunity in UKG Pro Recruiting. Use list_opportunities to find valid opportunity_id values

#### list_recruiting_processes

List recruiting process templates in UKG Pro Recruiting. Returns process names and stage definitions

#### get_recruiting_process

Get a single recruiting process template by ID from UKG Pro Recruiting. Use list_recruiting_processes to find IDs