What does the integration do?

This integration seamlessly connects Recruitee with Oneflow to streamline your hiring process. It automatically generates a contract in Oneflow based on predefined templates and candidate information from Recruitee. As the contract progresses, key data stays synchronized between the systems, and real-time status updates are added as notes on the candidate's Recruitee profile. Once signed, the completed contract can be automatically uploaded back to Recruitee for easy access and record-keeping.

Setting up the integration

To enable the Recruitee x Oneflow integration, the Recruitee API Token, Recruitee Company ID, Oneflow API Token, and the email address of the Oneflow administrator account must be located. This document will show you where to find these values.

In Recruitee

From Recruitee, the company ID and the API token must be saved. To find the page where this information is located:

1. Open settings

Click on the cog in the top-right of the page.

2. Go to 'Personal API tokens'

On the settings page, on the left pane, scroll to ‘Apps and plugins’, and click on ‘Personal API tokens’.

3. Create a new token:

Create a new API token by clicking on the ‘+ New token’ button.

4. Give the token a name:

5. Copy the value that has now appeared in the box under the newly created name:

This is the API Token. Copy and save this token in a secure location on your system, as you will require this later on in the process to connect to Oneflow.

6. Copy the Company ID:

Copy your company ID; this will be needed by the integration.

In Oneflow

The next few steps are done in Oneflow.

1. Go to the marketplace:

From the left sidebar, go the Marketplace by clicking the following button.

2. Open the Recruitee plugin from Connectstuff:

Search through the marketplace, locate ‘Recruitee by Connectstuff’, and click on it.

3. Click on 'Enable':

Click the Enable button on the plugin page.

4. Press the setup button:

Click on the ‘Setup’ button that appears when you enable the integration.

5. Fill in the Recruitee details:

• The ‘Company ID’ field must be filled in with the company ID obtained in step 'Copy the Company ID'.
• The ‘Token’ field must be filled in with the value retrieved in step 'Copy the value that has now appeared in the box under the newly created name'.
• When the fields have been filled, click on ‘Save integration’.

6. Configure the integration

If the Recruitee data is correct, the integration can be configured under the 'Default Data' tab.

7. Set up Recruitee webhooks:

You can find the webhooks that need to be configured for the integration to work under the ‘Webhook Help’ tab.

These are:

• On pipeline move, https://webhook-proxy.hoststuff.net/spzcociibz3gfl
• Job updated, https://webhook-proxy.hoststuff.net/oeos9bkxyqvefr

The webhooks can be set up in Recruitee in the settings under ‘Apps en Plugins’ > ‘Webhooks’

What data is sent from your solution to Recruitee (and/or vice versa)

We retrieve the following data:

• ID
• Initials
• Name
• Email
• Phonenumber
• Offer ID
• Recruiter e-mail
• Recruiter last_name
• Recruiter first_name

Any data that is contained in candidate fields and is configured to be mapped to Oneflow data fields by the customer

Besides that, we send notes/comments back to Recruitee. Additionally, we also upload the signed contract from Oneflow back to Recruitee.

How can customers reach you?

Commercial: Dirk-Jan.schmidt@oneflow.com
Technical (integration): support@connectstuff.nl

Step-by-step workflow

This is a step-by-step workflow on how to use the integration to create Oneflow contracts for Recruitee candidates automatically.

1. Create a new Job

Create a new blank job or a job from a template.

2. Add the Oneflow tag to the job

This tells the integration that this job should be managed by it.

3. Manage the job settings

Configure the job-specific settings for the integration by clicking on the link in the notes.

• The ‘Trigger on stage reached’ option defines the stage the candidate needs to reach in the Recruitee funnel before the contract is created in Oneflow. 
• The ‘Template’ option defines the oneflow template to use to create the Oneflow contract.

Under the ‘Fields’ option, the mapping of Recruitee candidate fields to Oneflow data fields can be edited:

Only custom Recruitee fields can be mapped to Oneflow fields. Currently, the Salary, Number, Date, Single choice, Yes / No, Multi-line text, and Single-line text custom field types are supported for the mapping. ‘Extracted from CV’ fields are currently not supported by the integration.

4. Create a new candidate

Click + Add candidates to create a new candidate and fill in the necessary fields.

5. Move the candidate to the funnel stage defined in job-specific settings

This will trigger the creation of a contract, which can be found in the notes section.

6. Open the contract through the link in the note and send it to the candidate

Send the contract to the candidate through the ‘Send’ button or by using the ‘Send contract to candidate automatically’ option in the job-specific settings.

7. Sign the contract and wait for the candidate to sign the contract

The state of the contract will be saved in the candidate notes in Recruitee.

• The contract will automatically be uploaded to Recruitee when the ‘Download contract to candidate card when signed’ is turned on. 
• When the ‘Move candidate when complete’ option is turned on, then the candidate will be moved to a specified funnel stage when the contract has been completed.