Early Access (EA)This API is currently in Early Access and available only to approved EA participants. Do not rely on this version for production workloads unless explicitly authorized. If you have any feedback, please share with your designated Early Adoption program representative.
What is the Skills & Certifications API?
The Skills & Certifications API gives clients and partners access to the skills, certifications, and licenses tracked in Paylocity. The API has two groups of endpoints:
- Company Skills: Manage the company's skill catalog, which is the list of skills a company tracks and their settings. See the Company Skills Overview.
- Employee Skills: Assign, renew, update, and remove skills on individual employees, and attach supporting documents such as a certificate or license copy. See the Employee Skills Overview.
Why use this API?
Many organizations track employee skills and certifications in separate systems like learning platforms, compliance tools, and licensing systems. This API keeps Paylocity in sync automatically, so admins don't have to re-key data and employee profiles stay accurate.
Common use cases
- Learning & training platforms: Record a certification on the employee's profile when they pass a course.
- Compliance & licensing tools: Track licenses with expiration dates and renew them when employees recertify.
- Workforce & scheduling systems: Pull employee skills and expiration status to see who is qualified, up for renewal, or expired.
- Initial setup: Load a client's skill catalog and existing employee certifications during onboarding.
Before you begin
You need the Employee IDEmployee Skills endpoints require a Paylocity Company ID and Employee ID.
- Employees who already have skills: Call List Company Employee Skills. Each record's
assignmentsarray includes the person's Company ID and Employee ID.- Employees with no skills yet (for example, assigning someone's first skill): Use the Employee Demographics v2 API to get the Employee ID.
Skills are shared across the company set
Skills are stored at the company set level, which is a group of Company IDs that share data, identified by relationshipId. You always call the API with a Company ID, but:
- Company Skills: The response includes all skills in the company set. Skills created through one Company ID are visible to every Company ID in the set.
- Employee Skills: Skills are stored per person (
personId). Calling an Employee ID returns all of that person's skills, including skills added through their other Employee IDs in the set.
See each overview page for details.
Example workflow: Sync a certification from a training platform
This example shows how the Company and Employee endpoints work together when an employee completes a forklift certification course.
| Step | Call | Purpose |
|---|---|---|
| 1 | Employee Demographics v2 API | Get the employee's Employee ID if you don't already have it. |
| 2 | List Company SkillsGET /companies/{companyId}/skills?skillCode=FORKLIFT | Find the skill in the catalog and save its skillKey. |
| 3 | Create SkillPOST /companies/{companyId}/skills(only if step 2 returns nothing) | Add the skill to the catalog and save the returned skillKey. |
| 4 | List Employee SkillsGET /companies/{companyId}/employees/{employeeId}/skills | Check if the employee already has the skill and what its status is. |
| 5 | Create Employee Skill Document UploadsPOST /companies/{companyId}/employees/{employeeId}/skillDocuments(optional) | Reserve an upload for the certificate. Save the documentKey, then upload the file to the uploadUrl. |
| 6 | Add Or Renew Employee SkillPOST /companies/{companyId}/employees/{employeeId}/skills | Assign the skill using the skillKey and include the documentKeys you saved. If the employee already has the skill, it is renewed. |
| 7 | Get Employee SkillGET /companies/{companyId}/employees/{employeeId}/skills/{employeeSkillKey} | Confirm the record and attached documents. |
Later, to keep data current:
- Use List Company Employee Skills to monitor
expirationStatusacross all employees. - Use Update Employee Skill (Partial) to correct details, and Add Or Renew Employee Skill to record a recertification.
How skills are used in Paylocity
- Reporting: The Employee Skills & Certifications dynamic report shows all of an employee's skills. Separate reports show skills that are expiring or expired, and skills an employee is missing for skills required by a position.
- Time & Labor (Scheduling+): Admins can set positions in Position Management to require certain skills. When an admin builds a shift in Scheduling+ and adds employees, Paylocity warns the admin if the employee doesn't have the position or required skills, or if a skill is expired. The warning can be overridden; it is not a hard stop.
Good to know
- Rate limit: 3 requests per second. If you get a
429 Too Many Requests, wait briefly and retry with a backoff strategy. - Pagination: List endpoints use
offsetandlimit(1–100, default 100). SetincludeTotalCount=trueto get the total count in theX-Pcty-Total-Countheader. - Test mode: Set
testMode=trueto get sample responses without reading or changing real data. Authentication and company access are still checked. - PATCH requests: Use JSON Patch (RFC 6902) and return
204 No Content. Call the matching GET endpoint to confirm the change. - Timeout: Requests time out after 30 seconds. For list endpoints, try a smaller
limit.