You set up a job in Recruitee, and only then does the real work start. The same text again on your own site, the industry and salary filled in a second time, and as soon as someone applies, their details and CV typed over into Recruitee by hand. Every job twice, every applicant twice — and every hand-over is a chance for something to go wrong.

With the Recruitee connection you do it once. Booston pulls in your published Recruitee jobs, including texts, attributes and the recruiter attached to them, and sends applicants back to Recruitee automatically with their CV and cover letter. Change a candidate's status in Recruitee and Booston follows. The end goal: Recruitee stays your only place of entry, and everything you publish there appears on your site and in your campaigns by itself.

After this article you know which three details you need from Recruitee, how to set up the connection yourself through the setup wizard, how to decide which fields you take over, and how to check that a job came in correctly. You will find the screen under Menu → Settings → Connect → Ats.

Before you start

• Your Recruitee plan supports personal API tokens. Not every plan does; check the Recruitee plans if you are unsure.
• You are an admin in the Recruitee company that holds the jobs, because only then can you create a token.
• The Ats module is switched on for your Booston environment and your user role has access to Settings → Connect.
• There is at least one published job in Recruitee. Without a published job there is nothing to pull in and no way to check the result.

What the connection does for you

The connection runs both ways. Everything to do with the job comes in from Recruitee; everything to do with the applicant goes back out from Booston.

Three things are worth knowing up front:

• How fast it goes. Booston pulls in your jobs on a fixed round; count on a maximum of twenty minutes between publishing in Recruitee and being visible in Booston. Recruitee does not send a real-time signal when something changes, so publishing instantly is not possible.
• Attributes are matched automatically. You do not have to tie a field to a Recruitee field by hand on the Booston side. All you decide is which fields you take over.
• Multilingual works, but only halfway. Booston pulls in every language version of a job you have in Recruitee, with no limit. Recruitee does not translate attribute values itself — values such as "Logistics" or "Full-time" are translated in Booston.

Step 1: collect your details from Recruitee

You need three things. Keep them at hand; you enter them in Step 3: enter your connection details.

1. Log in to Recruitee and go to Settings → Apps and plugins → Personal API tokens.
2. Click + New token at the top right and copy the token that appears. This is your personal API token.
3. Note down your Company ID. It is on the same screen, and also under Settings → Company Settings → General and in the url of your Recruitee dashboard after company=.
4. Note down your subdomain: the part before .recruitee.com in the address of your careers site. If your site is at https://example.recruitee.com, your subdomain is example.

There is more background in the Recruitee API documentation.

Step 2: start the connection and choose Recruitee

1. In Booston, go to Menu → Settings → Connect and click the Ats tab.
2. If it says Ats is not connected, click Connect. The setup wizard opens.
3. Under Select ATS, pick Recruitee from the list. You will recognise it by the logo.
4. Click Next.

For Recruitee the wizard has four steps: Select ATS, Main settings, Functionality and Activation. You can move back and forth between steps with Previous and Next; nothing is saved until you click Save in the last step.

Step 3: enter your connection details

Under Main settings the wizard only shows the fields Recruitee needs. You will not see a username and password here: Recruitee works with a token instead of a login.

Then click Next.

Step 4: choose what the connection does

Under Functionality you switch each function on or off. The settings that matter for Recruitee are under Sync.

Under Real time connection settings you will find the webhook settings. Recruitee does not support real-time notifications here yet, so leave those off — the fixed round from What the connection does for you picks up your changes. Click Next.

Step 5: activate the connection

The last step decides what happens to your current setup at the moment the connection goes live. Read the four switches carefully before you save.

Click Save. You will see Synchronization in progress; Booston is pulling in your jobs at that moment. This can take a few minutes. Once it is done, the You are connected screen appears.

Step 6: set up your job texts

The connection is live, but you have not yet decided which texts you take over from Recruitee. You do that under the attributes. Start with the texts, because they decide what your job page looks like.

Go to Menu → Settings → Attributes → Job attributes. The screen is split into sections: Title And Description, General, Salary, Location, Media and Other. The texts are in Title And Description.

Every text field in Booston is linked to a text field in Recruitee automatically. This is how the same job looks in Recruitee:

Two switches per attribute decide what happens:

• Status off means: the attribute is not active in Booston and the matching text is not pulled in from Recruitee.
• Sync with ATS on means: Recruitee fills this text automatically. This is what you want in most cases.
• If Status is on but Sync with ATS is off, the field stays empty until you fill it in on the job in Booston yourself.

Click the pencil icon to configure the attribute further. The most important fields:

Step 7: set up your other job attributes

In the other sections — General, Salary, Location, Media and Other — you manage the attributes with fixed values: industry, contract type, salary, location and so on.

The two switches work exactly as they do for the texts: Status decides whether the attribute exists in Booston, Sync with ATS whether Recruitee fills the value. Switch Sync with ATS off while Status is on, and you fill the value in yourself under Menu → Recruitment → Jobs → edit job.

The edit screen of an attribute with values has a few extra fields compared to the texts:

Next to the pencil icon there is a list icon. It opens all the values that came in through Recruitee, for example every industry or every contract type.

If a Recruitee job comes in with a value Booston does not know yet, that value is added to this list automatically. You can edit it there and then and detach it from Recruitee — handy if you use "FT" in Recruitee but want "Full-time" on your site, or if you need the value in a second language.

Publish a job in Recruitee

From now on you create jobs where you always created them: in Recruitee. These are the fields Booston takes over the moment you publish.

Then take the job live through the status dropdown, by setting the status to Published:

Watch the publication dates while you are there. If you fill them in, make sure the end date is in the future and the start date is not — otherwise Booston politely waits until that start date and the job looks like it never arrived.

On the next round your job is in Booston. Check it under Menu → Recruitment → Jobs.

From that moment the job joins in everywhere: on your website, in your Job feed and in your campaigns on the Jobboard network.

Applicants and statuses

When someone applies through your Booston website, this happens automatically:

1. The candidate is created in Recruitee with name, email address and phone number, with Booston as the source.
2. The candidate is linked to the job they applied for. That does not happen for an open application — that one comes in without a job.
3. The CV and cover letter are sent along as attachments, with the CV marked as the CV in Recruitee.

Move the candidate to a later stage in Recruitee and Booston takes that status over on the next round. Which Recruitee stage maps onto which Booston status is fixed for your environment; see What you cannot arrange yourself.

Changing the connection later

Go to Menu → Settings → Connect → Ats. Once the connection is live you see two cards:

• ATS with the text You are connected and the Disconnect button.
• Settings, with the Main Settings and Ats Functions blocks you expand and collapse.

Change what you need and click Save. Unlike the first-time setup, the four switches from Step 5: activate the connection do not appear here, so an ordinary change can never throw your jobs away by accident.

What you cannot arrange yourself

• The translation of Recruitee stages into Booston statuses. Which stage from your Recruitee pipeline maps onto which Booston status is configured for you by Booston. If something is off in how your candidates move through, tell us which stage you use in Recruitee and which status you expect in Booston.
• The frequency of the synchronisation. It is fixed for your whole environment and cannot be set per client.
• Switching the connection on in the first place. If the Ats tab is not in your menu, the module is not active for your environment. The helpdesk arranges that.

Troubleshooting

No jobs come in at all

Usually the Base url or the subdomain is wrong, or there is no job set to Published in Recruitee yet. First check whether your careers site at https://<subdomain>.recruitee.com actually shows jobs; what is not there cannot be pulled in by Booston either.

One job is missing, the rest are there

Look at the publication dates of that job in Recruitee: a start date in the future or an end date in the past holds it back. Then check the language of the job — if that language is not switched on in your Booston environment, the job is skipped.

Jobs come in, but fields stay empty

Then the attribute has Status on but Sync with ATS off. Switch it on under Menu → Settings → Attributes → Job attributes; the field is filled on the next round.

Applicants do not arrive in Recruitee

Check whether Candidate export is on under Ats Functions. If it keeps failing, the token has often been revoked, or it belongs to a different Recruitee company than the Client id you entered. Create a new token in that case and enter it again.

The connection worked and has suddenly gone quiet

A personal API token belongs to one user. If that colleague leaves and the account is deleted, the connection stops. Create a new token under an account that will stay.

Frequently asked questions

Can I create jobs in Booston instead of in Recruitee?

You can, but it is not what this connection is for. Anything set to Sync with ATS is overwritten by the value from Recruitee on the next round. If you want to manage a field in Booston, switch Sync with ATS off for that attribute.

Does the connection work with several languages?

Yes, with no limit on the number of languages. Recruitee does not translate the attribute values itself, so you manage those translations in Booston under the attribute values.

Do I need a separate connection for each Recruitee company?

Yes. A token only works for one company, and the Client id points at one company. Several Recruitee companies means several Booston environments.

What happens if I delete a job in Recruitee?

On the next round that job is no longer in the list Recruitee returns, so it disappears from Booston and from your website too.

Does a Recruitee API token cost extra?

The token itself does not, but not every Recruitee plan gives access to personal API tokens. You can read that back under the Recruitee plans.

Coming soon

• Recruitee on our new connection platform. We are moving the Recruitee connection to the platform our newer ATS connections already run on. Pulling in jobs, attributes and recruiters becomes faster and easier to follow, and Booston will recognise whether a job has genuinely changed — if nothing changed, nothing is updated.
• The connection as a step in the guided setup. For new environments the ATS connection is becoming a fixed step in the setup wizard, with the same four steps you have just been through. You get one extra choice there: giving colleagues who come in through your ATS a Booston account automatically. We will update this article as soon as it is live.

Need help?

Cannot work it out, or unsure which setting suits your situation? Email support@booston.io or call 085 0044 215 and mention:

• the name of your environment;
• what you want to achieve;
• the message you see, if there is an error message.

Would you rather go through the settings together? Book a free 30-minute online demo — then we will walk through it with you. Job Done!