What's covered in this guide?
Overview
The CPL Learning integration connects your workforce management platform to CPL Learning, allowing you to keep employee records in sync and automatically capture completed training courses as qualifications.
The integration performs two key functions:
Staff sync – Pushes employee records to CPL Learning whenever staff are added, updated, or deactivated.
Qualifications import – Pulls completed CPL courses back into the platform and records them as qualifications against employees.
Before you begin
Before setting up the integration, you'll need:
An API Key from CPL Learning (your account's X-API-KEY)
Matching team names between your workforce platform and CPL Learning
Matching position names between your workforce platform and CPL Learning
📝 Important to note: Team and position names must match their CPL Learning equivalents exactly. These values are used to assign employees to the correct division and job position in CPL Learning.
If you don't have an API Key, contact your CPL Learning account manager.
Set up the integration
To connect CPL Learning to your account:
Navigate to Settings > Integrations
Search CPL Learning
Enter your API Key
Choose your preferred sync options
Click Save
Once saved, the integration will begin syncing employee data according to your selected settings.
Sync options
Automatically sync staff to CPL
When enabled, any employee who is created, updated, or deactivated is automatically pushed to CPL Learning.
This helps keep employee records up to date without requiring manual updates in CPL.
The following employee details are synced:
Name (legal first and last name where available, otherwise display name)
Email address
Employment start date
Employment end date
Active or inactive status
Team (mapped to CPL division)
Position (mapped to CPL job position)
Location (mapped to CPL site)
📝 Important to note: Team, position, and location names must match the corresponding values in CPL Learning exactly. If CPL rejects one of these fields, the remaining employee information will still sync successfully.
Import course completions from CPL
When enabled, completed CPL Learning courses are imported and recorded as qualifications against each employee.
The imported qualification includes:
Course name (used as the qualification name)
Expiry date (where available)
Licence number (where available)
Courses are imported when their CPL status is:
Completed
Passed
Achieved
How the sync works
Staff updates
Employee changes are synced in real time. When an employee is created, updated, or deactivated, the change is automatically sent to CPL Learning.
Scheduled sync
A full sync also runs periodically to ensure records remain aligned and to capture any missed updates.
Employee deactivation
When an employee is deactivated, they are also deactivated in CPL Learning and their leave date is recorded.
Employee matching
New employees are automatically created in CPL Learning when required.
Existing employees are matched using their employee number.
⚠️ Important: Employees must have an employee number assigned. Without one, CPL Learning cannot identify, create, or update the employee record.
FAQs and Troubleshooting
Why isn't an employee appearing in CPL Learning?
Why isn't an employee appearing in CPL Learning?
Check that the employee has an employee number assigned.
CPL Learning uses the employee number to identify employees. Without one, the integration cannot create or update the record.
Why isn't a team, position, or location syncing?
Why isn't a team, position, or location syncing?
Verify that the name in your workforce platform matches the corresponding value in CPL Learning exactly.
Check for:
Differences in spelling
Capitalisation differences
Extra spaces before or after the name
Why aren't qualifications being imported?
Why aren't qualifications being imported?
Confirm that:
Import course completions from CPL is enabled in the integration settings.
The employee's course status in CPL Learning is marked as Completed, Passed, or Achieved.
What happens if CPL rejects a team, position, or location value?
What happens if CPL rejects a team, position, or location value?
The employee record will still sync successfully. Only the rejected field will be skipped.
What's not supported
The CPL Learning integration does not currently support:
Importing employees from CPL Learning into your workforce platform
Syncing employees who do not have an employee number assigned
Employee data sync is one-way: Workforce Platform → CPL Learning