For Agents
Manage employee records, retrieve pay statements, configure earnings and tax withholding, and set up direct deposits for companies using Paylocity payroll.
Get started with Paylocity API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"retrieve employee pay statement details"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Paylocity API API.
Retrieve detailed pay statements with earnings, deductions, and tax breakdowns by year or check date
Manage employee earnings configurations including recurring and one-time earning codes
Configure federal, state, and local tax withholding elections for employees
Set up and modify direct deposit accounts with split allocations
GET STARTED
Use for: I need to retrieve an employee's pay statement for this year, I want to add a new employee to the payroll system, Get the direct deposit configuration for a specific employee, Update an employee's federal tax withholding status
Not supported: Does not handle time tracking, recruiting, or benefits enrollment — use for payroll data, employee records, and compensation management only.
The Paylocity API provides programmatic access to employee payroll and human capital management data for US employers. It covers 32 endpoints spanning employee records, earnings management, pay statements, tax configurations, direct deposit setup, benefits, and sensitive HR data. The API uses OAuth 2.0 client credentials and includes a WebLink staging endpoint for onboarding new hires in bulk.
Create new employee records with demographics, compensation, and tax data
Search employees by pay rate ranges or employment status across a company
Access sensitive employee data including SSN and date of birth through elevated permissions
Patterns agents use Paylocity API API for, with concrete tasks.
★ Pay Statement Reporting
Retrieve detailed pay statement data for employees including summaries and line-by-line details by year or specific check date. The API returns gross pay, net pay, all earning codes, deductions, and tax withholdings. This powers internal dashboards, employee self-service portals, and annual compensation reporting without manual data exports from the Paylocity UI.
Retrieve the pay statement summary for employee {employeeId} in company {companyId} for the year 2026 via GET /v2/companies/{companyId}/employees/{employeeId}/paystatement/summary/2026
Employee Onboarding and Data Management
Create new employee records with complete demographic, compensation, tax, and direct deposit information through the API. The WebLink staging endpoint supports bulk imports for organizations hiring at scale. Existing employee records can be updated with PATCH requests covering name changes, address updates, or role transitions.
Create a new employee in company {companyId} via POST /v2/companies/{companyId}/employees with name, hire date, annual salary of $65,000, and federal tax filing status of single
Tax and Compensation Configuration
Manage all aspects of employee tax withholding including federal, primary state, non-primary state, and local tax codes. The API supports adding new local tax jurisdictions, updating withholding elections, and removing obsolete tax records. Combined with earnings management endpoints, this enables complete compensation lifecycle handling from hire through termination.
Add a new local tax code for employee {employeeId} in company {companyId} via POST /v2/companies/{companyId}/employees/{employeeId}/localTaxes with the jurisdiction code and withholding percentage
AI Agent Payroll Integration via Jentic
AI agents connect to the Paylocity API through Jentic to retrieve pay data, manage employee records, and configure compensation without implementing OAuth 2.0 client credentials or handling token lifecycle management. Jentic provides intent-based search so agents find operations like 'get pay statement' and receive the complete endpoint schema ready for execution.
Search Jentic for 'retrieve employee pay statement', load the operation schema, and execute it for employee {employeeId} in company {companyId} for the current year
32 endpoints — the paylocity api provides programmatic access to employee payroll and human capital management data for us employers.
METHOD
PATH
DESCRIPTION
/v2/companies/{companyId}/employees
Create a new employee record
/v2/companies/{companyId}/employees/{employeeId}
Retrieve employee details
/v2/companies/{companyId}/employees/{employeeId}/paystatement/details/{year}
Get detailed pay statements for a year
/v2/companies/{companyId}/employees/{employeeId}/earnings
List employee earnings
/v2/companies/{companyId}/employees/{employeeId}/directDeposit
Get direct deposit configuration
/v2/companies/{companyId}/employees/{employeeId}/primaryStateTax
Update primary state tax
/v2/companies/{companyId}/employees/{employeeId}/localTaxes
Add local tax configuration
/v2/weblinkstaging/companies/{companyId}/employees/newemployees
Bulk stage new employees via WebLink
/v2/companies/{companyId}/employees
Create a new employee record
/v2/companies/{companyId}/employees/{employeeId}
Retrieve employee details
/v2/companies/{companyId}/employees/{employeeId}/paystatement/details/{year}
Get detailed pay statements for a year
/v2/companies/{companyId}/employees/{employeeId}/earnings
List employee earnings
/v2/companies/{companyId}/employees/{employeeId}/directDeposit
Get direct deposit configuration
Three things that make agents converge on Jentic-routed access.
Credential isolation
Paylocity OAuth 2.0 client credentials are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped bearer tokens — the client secret never enters the agent's context window.
Intent-based discovery
Agents search by intent (e.g., 'get employee pay statement') and Jentic returns the matching Paylocity operation with path parameters and query options, so the agent can target the right endpoint without browsing 32 endpoints.
Time to first call
Direct Paylocity integration: 3-5 days for OAuth setup, endpoint mapping, and error handling. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Paychex External API
US payroll platform with broader endpoint coverage for checks, jobs, and webhooks
Choose Paychex when the employer uses Paychex payroll or when you need webhook-based event notifications for worker lifecycle changes.
Gusto API
SMB-focused payroll with integrated benefits, tax filing, and compliance
Choose Gusto when the employer is a small business needing all-in-one payroll with automated tax filings and benefits enrollment.
BambooHR API
HR platform for employee records, time-off, and performance beyond payroll
Use BambooHR alongside Paylocity when you need broader HR features like PTO tracking, performance reviews, and applicant tracking that Paylocity does not expose via API.
Specific to using Paylocity API API through Jentic.
What authentication does the Paylocity API use?
The Paylocity API uses OAuth 2.0 client credentials flow. You obtain a token by posting your client ID and secret to api.paylocity.com/IdentityServer/connect/token with the WebLinkAPI scope. Through Jentic, OAuth credentials are stored in the MAXsystem vault and agents receive scoped tokens automatically.
Can I retrieve detailed pay statements with the Paylocity API?
Yes. The GET /v2/companies/{companyId}/employees/{employeeId}/paystatement/details/{year} endpoint returns line-item detail including each earning code, deduction, and tax withholding for every check in that year. You can also filter by specific check date using the /{checkDate} path suffix.
What are the rate limits for the Paylocity API?
Paylocity enforces rate limits per OAuth client. Standard integrations are limited to approximately 5 requests per second with daily quotas based on your subscription. The API returns 429 Too Many Requests when limits are exceeded. Jentic handles rate limiting and retry logic when executing operations.
How do I add a new employee through the Paylocity API via Jentic?
Search Jentic for 'create a new employee in payroll' to find the POST /v2/companies/{companyId}/employees operation. Jentic returns the full input schema including required fields like firstName, lastName, companyId, and employeeStatus. Execute through Jentic and it handles OAuth token acquisition. Install with pip install jentic.
Can I manage tax withholding configurations via the API?
Yes. The API provides PUT /v2/companies/{companyId}/employees/{employeeId}/primaryStateTax for state tax, PUT /v2/companies/{companyId}/employees/{employeeId}/nonprimaryStateTax for secondary states, and POST and DELETE operations on /v2/companies/{companyId}/employees/{employeeId}/localTaxes for local jurisdictions.
Does the Paylocity API support bulk employee imports?
Yes. The POST /v2/weblinkstaging/companies/{companyId}/employees/newemployees endpoint stages multiple new employee records through the WebLink system. This is designed for bulk onboarding scenarios where organizations need to add many employees simultaneously during seasonal hiring or acquisitions.
/v2/companies/{companyId}/employees/{employeeId}/primaryStateTax
Update primary state tax
/v2/companies/{companyId}/employees/{employeeId}/localTaxes
Add local tax configuration
/v2/weblinkstaging/companies/{companyId}/employees/newemployees
Bulk stage new employees via WebLink