Connecting Paycom to Ploy
Connect Paycom to Ploy so Ploy can use your Paycom employee directory as an HR source of truth. Ploy reads your employees, their work email, job title, department, manager and employment dates, and whether each person is active, on leave, suspended or terminated. Ploy only reads from Paycom. It never changes an employee record.
This integration is in beta
The Paycom integration is in beta. It was built from Paycom's API documentation and has not yet been run against a live Paycom company, so some details may not match your account. If something looks wrong after you connect, contact Ploy support and we will fix it.
The first step of setup is a consent checkbox. Ticking it lets Ploy record redacted error data when a Paycom request fails. That means the status code and the shape of Paycom's error response, with names, emails, tokens and other personal or secret values removed. We use it only to fix the integration while it is in beta.
Before you start
Paycom does not offer self-serve API credentials. You need an API SID and an API token from Paycom:
Contact your Paycom representative and ask for API access for Ploy.
Ask for read access to the employee directory and to individual employee records. Ploy does not need any write access.
Paycom will give you an API SID and an API token. Keep the token somewhere safe until you have pasted it into Ploy.
Connect Paycom in Ploy
In Ploy, go to Integrations and choose Paycom.
Tick the beta consent checkbox.
Paste your API SID.
Paste your API token.
Select Test connection. Ploy reads the first page of your employee directory to check the credentials work.
Save the integration.
If the test fails:
"Paycom rejected that API SID and token" means the SID and token do not match or were not pasted in full. Paste both again.
"That API credential cannot read the employee directory" means the credential works but lacks directory access. Ask your Paycom representative to add it.
What Ploy reads
Employees. Every employee in your directory, keyed on their Paycom employee code.
Employee details. For each employee: work email, personal email, name, job title, department, primary supervisor, hire or re-hire date, and termination date.
Status. Active, on leave and suspended employees are treated as current employees. Terminated employees are shown as no longer having access, from the day after their termination date.
Ploy does not read pay, tax, benefits, date of birth, demographic, emergency contact, phone or home address fields, even though Paycom's employee record includes them.
How often Ploy scans
Ploy scans Paycom once a day. Each scan reads the directory and then each employee's record, so a large directory takes a while to complete.
Limits
Ploy cannot look up a Paycom employee by email address in Luna or search, because Paycom's directory does not include email. Search by employee code or full name instead.
Departments are shown on each person. They are not shown as separate resources.
Ploy does not create, update, suspend or remove Paycom employees. Make those changes in Paycom and Ploy will pick them up on the next scan.