Recruiterflow
Ploy connects to Recruiterflow with a workspace API key and reads your team members and their roles. Ploy only reads from Recruiterflow; it never changes anything there.
The Recruiterflow integration is in beta. It was built from Recruiterflow's API reference and has not yet been run against a real Recruiterflow workspace, so the first connections are watched closely by the Ploy team.
What Ploy shows
Every team member in your Recruiterflow workspace (recruiters, hiring managers and admins), matched to your people by email.
Access to Recruiterflow for each team member, with each of their Recruiterflow roles. A person with several roles shows each one. A person with no role shows "No role".
People removed from the workspace are shown as removed on the next scan.
Candidates are not imported: they are job applicants, not people with access to your workspace.
Ploy cannot add, change, deactivate or remove Recruiterflow users, because Recruiterflow's API is read only. Make those changes in Recruiterflow's settings.
Before you start
You need a Recruiterflow workspace API key. A Recruiterflow admin can find it in Settings > Integrations in Recruiterflow. If your workspace does not show one there, ask Recruiterflow support for an API key through in-app chat or by emailing [email protected], and say it is for connecting Ploy to your workspace.
Treat the key like a password. It gives access to your whole workspace.
Connect Recruiterflow
In Ploy, go to Integrations, find Recruiterflow and click Connect.
Tick the beta consent checkbox. This is the first step of setup for any beta integration. It lets Ploy record redacted error details when a call to Recruiterflow fails: the error status and the shape of the reply, with names, emails, keys and other values removed. Ploy uses this only to fix problems with the integration.
Paste your Recruiterflow API key.
Click Test connection. Ploy reads your team member list to check the key works.
Save. The first scan starts straight away and then runs every hour.
Troubleshooting
"Recruiterflow rejected that API key": the key is wrong or has been regenerated. Copy it again from Recruiterflow and paste it in full.
"That API key cannot read your Recruiterflow team members": ask Recruiterflow support to confirm the key has API access to users.
"Connected, but the response wasn't what we expected": Recruiterflow answered without a team member list. Contact Ploy support so we can check the integration.