Integration

Paylocity WebLink integration

Paylocity WebLink is the Paylocity Payroll/HR API for a company's own employee data. List employees and read an employee's full record, hire employees directly or through Web Link staging, update employee records, and manage per-employee earnings, additional pay rates, local, primary and non-primary state taxes, emergency contacts, benefit setup and sensitive self-identification data; read direct deposit accounts, pay statement summaries and details by year or check date, company setup codes and custom field definitions. Not exposed: client secret rotation, the company-specific OpenAPI document, the closed-beta pay rate and status searches, and the older v1 deduction, onboarding and local-tax update routes; Paylocity's newer apiHub APIs are a separate integration. Authentication is OAuth2 client credentials (scope WebLinkAPI) that Paylocity issues to an approved customer or partner, scoped to the company numbers Paylocity allowed.

Connect Paylocity WebLink How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Paylocity WebLink.Built from the 28 Paylocity WebLink tools below, on the connection you add once.

What you can do with Paylocity WebLink

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Earning, 5 operations

delete_earningDelete earningDELETEDeletes the earning of an employee identified by its earning code and start date.
get_earningGet earningGETReturns the single earning of an employee with the given earning code and start date.
list_earningsList earningsGETLists every recurring earning set up for an employee: earning code, calculation code, amount or rate and hours, start, effective and end dates, per-check limits, annual maximum, goal and cost centers.
list_earnings_by_codeList earnings by codeGETLists every earning of one earning code for an employee (one per start date).
upsert_earningUpsert earningPUTAdds or updates a recurring earning for an employee. earningCode (from list_company_codes with codeResource earnings) and startDate are required; amount, rate, hours, limits, goal, frequency and cost centers are optional.

Employee, 4 operations

create_employeeCreate employeePOSTHires an employee directly into Paylocity Payroll/HR and returns the employee id (blank employeeId takes the next free id). The New Hire Template may require more fields than marked here. For an incomplete record use create_staged_employee.
get_employeeGet employeeGETReturns one employee's full record: names, birth date, addresses, department and position, status and hire dates, pay rates, federal, state and local taxes, direct deposit, benefit setup, emergency contacts, custom fields and work eligibility.
list_employeesList employeesGETLists the employees of a company, 25 per page by default (pagenumber is 0-based), each with its employee id, current work status (A active, L leave of absence, T terminated) and status type. Use get_employee for one employee's full record.
update_employeeUpdate employeePATCHUpdates an existing employee in Paylocity Payroll/HR with the fields sent (names, addresses, status, department and position, pay rate, taxes, direct deposit, custom fields). Sending direct deposit accounts replaces all existing ones.

Local tax, 4 operations

create_local_taxCreate local taxPOSTAdds a local tax to an employee: tax code, filing status, exemptions and, in Pennsylvania, the resident and work PSD codes.
delete_local_taxDelete local taxDELETEDeletes the local tax with the given tax code from an employee.
get_local_taxGet local taxGETReturns the local tax of an employee with the given tax code: filing status, exemptions and PSD codes.
list_local_taxesList local taxesGETLists every local tax set up for an employee: tax code, filing status, exemptions and the Pennsylvania resident and work PSD codes.

Detail, 2 operations

list_pay_statement_detailsList pay statement detailsGETLists the pay statement detail lines of an employee for a year, one per earning, deduction or tax on each check: code and type, amount, hours, rate and check date. Paged (25 per page by default, pagenumber 0-based); dettypes narrows to given codes.
list_pay_statement_details_by_check_dateList pay statement details by check dateGETLists the pay statement detail lines of an employee for one check date, one per earning, deduction or tax: code and type, amount, hours and rate. Paged (25 per page by default, pagenumber 0-based); dettypes narrows to given codes.

Sensitivedata, 2 operations

get_sensitive_dataGet sensitive dataGETReturns an employee's sensitive self-identification data: disability, ethnicity and race, gender identity and pronouns, and veteran status.
upsert_sensitive_dataUpsert sensitive dataPUTAdds or updates an employee's sensitive self-identification data: disability, ethnicity and race, gender identity and pronouns, and veteran status.

Summary, 2 operations

list_pay_statement_summariesList pay statement summariesGETLists an employee's pay statement summaries for a year, one per check: check date and number, period dates, gross and net pay, direct deposit amount, regular and overtime hours and dollars. 25 per page by default, pagenumber 0-based.
list_pay_statement_summaries_by_check_dateList pay statement summaries by check dateGETLists the pay statement summaries of an employee for one check date: check number, pay period dates, gross pay, net pay, direct deposit amount, regular and overtime hours and dollars. Paged (25 per page by default, pagenumber 0-based).

Additional rate, 1 operation

upsert_additional_rateUpsert additional ratePUTAdds or updates an additional pay rate of an employee (a rate code with its rate per hour or week, effective date, and optional cost centers, job and shift). rateCode, rate, ratePer and effectiveDate are required by the vendor.

Benefit setup, 1 operation

upsert_benefit_setupUpsert benefit setupPUTAdds or updates an employee's benefit setup: benefit class and its effective date, benefit salary and its effective date, and the ACA eligibility measurement options.

Code, 1 operation

list_company_codesList company codesGETLists a company's setup codes of one kind with their descriptions: cost centers (costcenter1 to costcenter3), deductions, earnings, taxes, pay grades, positions and others. Use it to find the values other tools say must match company setup.

Customfield, 1 operation

list_custom_fieldsList custom fieldsGETLists a company's custom field definitions for one category: label, type, required flag, default value and allowed values. Companies on Paylocity's Unlimited Custom Fields platform must not use it (vendor rule).

Direct deposit, 1 operation

get_direct_depositGet direct depositGETReturns an employee's main direct deposit account and every additional one: routing and account numbers, account type, amount and amount type, pre-note settings.

Emergency contact, 1 operation

upsert_emergency_contactUpsert emergency contactPUTAdds or updates one emergency contact of an employee: name, relationship, priority (P primary or S secondary), phones and which is primary, email and address. firstName, lastName, relationship, priority and primaryPhone are required.

Newemployee, 1 operation

create_staged_employeeCreate staged employeePOSTSends a partial or possibly erroneous new hire record to Web Link staging, where a company administrator (or Paylocity's service bureau) completes it in Paylocity; returns a tracking number. Use create_employee to hire directly.

Nonprimary state tax, 1 operation

upsert_nonprimary_state_taxUpsert nonprimary state taxPUTAdds or updates an employee's non-primary state tax: state tax code, calculation code with amount or percentage, filing status, exemptions, W-4 amounts, reciprocity code and supplemental check handling.

Primary state tax, 1 operation

upsert_primary_state_taxUpsert primary state taxPUTAdds or updates an employee's primary state tax: state tax code, calculation code with amount or percentage, filing status, exemptions, W-4 amounts and supplemental check handling.

Use Paylocity WebLink from Claude Code, Cursor or Codex

Connect Paylocity WebLink in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Paylocity WebLink operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Paylocity WebLink

Create your workspace
Sign up free. Nothing to install.
Connect Paylocity WebLink once
Add your Paylocity WebLink connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.