Overview of Integration
We have partnered with Eploy to provide our Stepstone Connect solution, which lets job-seekers apply seamlessly for jobs posted on Stepstone Group job boards. All applications will be passed directly to Eploy, with confirmation of the source of this application.
How does it work?
Stepstone Connect is a free-to-use technology that enables a seamless integration between our Stepstone Group job boards and Eploy. When integrated, this will enable the automatic transfer of applicant data and CVs into your Eploy ATS.
This works by simplifying the job application process and removing the need for a candidate to re-enter their information on an external web form. We pull the screening questions and additional requirements from the Eploy careers site and ask the candidate to provide this information as part of their application on our site.
This leads to a much higher application completion rate, greatly reducing candidate drop-off in the application process.
Requirements
To activate Stepstone Connect, clients are required to provide the following information from Eploy:
- Link to Eploy job requisition
- API User
- IP Restrictions
- API Key
- Job Application Source value
You will find this information, as well as further explanations for each point, by following the instructions further below in your Eploy ATS.
Please send the above information to one of the following contacts, depending on your job board:
| Country | Job Board | Contact Email Address |
| Continental Europe | Stepstone DE | connect@stepstone.com |
| UK | Totaljobs / Caterer / Jobsite | connectuk@thestepstonegroup.com |
| Ireland | Irishjobs, Jobs.ie, NIJobs | connectuk@thestepstonegroup.com |
Please note, that administration access is required to enable you to complete these steps.
Steps to integrate and enable
Step 1: Create API User
To set up an API User, you must have User Admin access to Eploy system. If you do not have the ‘Users’ option in the Admin menu, your user account has not been configured to allow access to configure Standard Users.
Please consult with your Eploy administrator to set up the API User for you or grant you permission. You will need to have a user set up specifically for the API (i.e. not a user who is logging in to Eploy).
Create API User: Click on Admin → Users → New → User
- Complete the following:
- User Display Name: Use a unique name that describes the user, for this you can use “Stepstone API User”
- User Name: Use a unique name for your API user
- Password: Click ‘Update’, ‘Generate’ and then save the password
- Roles: Please assign the System Admin role for this user
- System Email Address; Email Display Name; Your Direct/Internal Email Address: Use a generic email address that is not used by any real users and is restricted only to administrators.
- Once you have set all these fields, click ‘Save’ to save the user record
Step 2: Assign IP Restrictions
Now that you have created the user record, for the user to be able to access the API, you need to specify at least one IP range.
- Specify at least one IP range in the ‘Restricted IP Access’ section:
- Click the ‘Add’ button to add a new IP range
- Click ‘Save’ once you have added all the required IP addresses/range
Step 3: Set up an API Key
In Eploy, go to Admin → Security Settings → API Keys → New → REST API
Please note that the daily API usage limit is shared across all API keys in your system. If you think the integration you are preparing to configure is likely to take you over the current daily limit, consult with your Eploy Account Manager.
- Specify the following fields:
- Title: Enter a name for your API Key. The name can be like Stepstone API Key
- Run as User: Select an API User for your API Key to use. This should be Stepstone API User you created in Step 1
- Once you have set both of these fields, click ‘Save’ to create the API Key
Please note that once you save the API Key, the Client Secret can no longer be accessed, therefore please note your Client ID and Client Secret before you navigate away from this record.
You can click into an existing API Key to make changes, but please be cautious as changing an existing key may affect any live integrations you may have.
- Assign API Permissions to your API Key:
- Click the ‘Add’ button in the API Permissions section
- Select the API endpoints you wish to grant permission to
- Tick the relevant boxes to assign ‘View’, ‘Insert’, ‘Update’ and ‘Delete’ permissions
- Click ‘Save’
Once you have assigned all the necessary API Permissions, click ‘Save’ to save your API Key.
Finally, please provide the API Username, Client ID and Client Secret to your Stepstone point of contact.
Step 4: Define a Job Application Source value
Application source allows you to understand which Stepstone job board was the source your applications are coming from.
All required sources have to be configured within Eploy before we can POST a candidate with that source.
- Select ‘Drop Down Lists’ option from the ‘Admin’ menu:
- Select the ‘How Did You Hear About Us – Details (Candidates)’ option in the ‘Show Values For’ picker
- Click on ‘New’ in the white toolbar & select the parent option ‘Job Board’, in the Description field ‘Stepstone’ and in the Search String field, type ‘stepstone’
Once this has been done, any applications from ‘stepstone’ will be set with this source.
Testing process
With all of the information you have provided and sources created in Eploy the Stepstone team can begin connecting to your Eploy instance. We will perform multiple steps mentioned below:
- Configure the integration within our internal system
- Set up a test job
- This will be set up on a test account and not use your account credits
- Apply for the job as a candidate
- Test to see if any screening questions are pulling through correctly, by cross-referencing with the Eploy apply page
- Send an application into Eploy
- Advise application has been sent and ask you to confirm that the application and source has come through as expected
Considerations:
- If we have any issues throughout this process, we will feedback to you in the first instance
Go Live
Once testing has been completed, we will await your confirmation to go live with the integration. At this point, we will turn on for all live jobs on your account.