All Collections
Recruitment integrations
Recruitee integration: add hired candidate to HoorayHR
Recruitee integration: add hired candidate to HoorayHR

In this article, we'll show you how the integration between Recruitee and HoorayHR allows you to push hired candidates through.

Nadja avatar
Written by Nadja
Updated over a week ago

If you are working with Recruitee and you have hired a new candidate, you can make sure that this candidate is added directly to HoorayHR. From there, you can onboard the new colleague and make sure his or her profile is populated in HooryHR. But first, how do you link Recruitee to HoorayHR?

Create linking data from within Recruitee

Before you can activate the integration in HoorayHR, in Recruitee there are a number of credentials that need to be created that can be used to create the link between the two systems.

Two pieces of information are required:

  • Company-ID

  • API token

These can be retrieved in Recruitee following the steps below:

Step 1. Go to "Settings"

Step 2. Then choose 'Apps and plugins'

Step 3. Select 'Personal API tokens' here. A new token can be created here.

  1. New token

  2. Give the token a name (for yourself, for example: 'link HoorayHR')

  3. The token will then appear

After creating a token, you can paste the company ID and token into the Hooray setup wizard. All the steps for that, you'll find below.

Activate integration in HoorayHR

Activating integration with Recruitee via HoorayHR is done through the steps below.

Step 1. In HoorayHR, go to the 'Integrations' tab

Step 2. Click here on 'Activate integrations'

Step 3. A new tab will then open and search for 'Recruitee' here

Step 4. Click Recruitee and fill in the following details:

  • Company ID (for explanation, see "Creating link details from within Recruitee")

  • API token (for explanation, see "Creating link details from within Recruitee")

  • Webhook secret (for explanation, see "Automatic import")

Step 5. Click 'Next'

Step 6. It worked! Click 'Done' to complete the wizard.

Importing employees

Adding new colleagues to HoorayHR from Recruitee can be done in 2 ways. One option is automatically as soon as a colleague is hired and is also assigned this status in Recruitee. The other way is a manual import into HoorayHR itself. Below, we will explain both variants.

Automatic import (via webhook)

To ensure that colleagues who have 'hired' status in Recruitee are added directly to HoorayHR, you need so-called 'webhooks' for this purpose. With these webhooks, Recruitee sends a signal to Hooray as soon as a candidate is hired.

Creating a webhook in Recruitee can be done as follows:

Step 1. Go to Settings in Recruitee

Step 2. Choose 'Apps and plugins' here

Step 3. Select 'Webhooks'

Step 4. Click on a new webhook

Step 5. Enter a name (for internal use, e.g. 'link HoorayHR')

Step 6. Enter the following "publish URL":

Step 7. Tick "Move within funnel"

Step 8. Click "Confirm and create"

Step 9. Copy the "Secret" at the bottom of the page (click "Show secret" first to bring it into view)

Step 10. Paste the copied "Secret" into the integration setup wizard

Note: If this is not activated, the import will not go automatically.

Once you set up the webhook, candidates that are set to "hired" in Recruitee are automatically created in HoorayHR. And should an import be run, all admins of the Hooray environment will receive an email notification about it.

Manual import

Besides automating new colleagues in HoorayHR, you can also import manually. Follow the steps below to perform a manual import into HoorayHR.

Step 1. Go to 'Colleagues'

Step 2. Click on 'Add colleagues'

Step 3. Next to the 'Add colleagues' button, click the down arrow for 'Import from Recruitee'

Step 4. Select from the list who you want to import.

Step 5. Click on 'Import'.

And you're done! Now you can complete this colleague's profile with all information, such as name and address details and contract dates. More information on how to fill the profile of the new colleague can be found on this page from our Helpcenter.

The following data is imported (if available) from Recruitee:

  • Name

  • E-mail address*

  • Telephone number*

  • Job title

  • Avatar

* if there are multiple e-mail addresses or phone numbers, the first one (in Recruitee, the top one) is used.

Disable e-mail notifications of imported candidates

When a candidate is automatically imported from Recruitee (via a webhook), all administrator users in your company are notified by email. If any errors occurred when importing the candidate, this will also be mentioned along with the reason why it failed.

If you do not want to receive these e-mail notifications, you can disable them as follows:

  1. Click on your profile picture at the top right > 'My settings'

  2. Go to the 'Notifications' submenu

  3. Uncheck 'Recruitee imports'

  4. Click on 'Save' in the top right corner

Did this answer your question?