KoppelingenRecruitee
Recruitee koppelen aan je website.
Recruitee is het wervingssysteem waarin vacatures, sollicitanten en het selectieproces staan. Er is een aparte API voor precies dit doel: je vacatures op je eigen site zetten en de sollicitatie daar laten binnenkomen, inclusief de screeningsvragen.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Recruitee je oplevert.
Een eigen pagina per vacature. Op je eigen domein, in je eigen opmaak, met een adres om naartoe te linken en op te adverteren.
Solliciteren op je eigen site. Het formulier maakt de kandidaat rechtstreeks in Recruitee aan, met het cv en de antwoorden erbij.
De screeningsvragen komen mee. Vragen die je in Recruitee instelt, verschijnen vanzelf in het formulier op je site.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- De Careers Site API op het adres van je eigen omgeving, jouwbedrijf.recruitee.com/api, met /offers voor de vacatures en /offers/:slug/candidates voor de sollicitatie. Daarnaast een XML-feed voor vacaturebanken en webhooks
- Authenticatie
- Een token in de header X-Careers-Sites-Token. Per 10 februari 2027 verplicht; zonder token volgt een 401
- Richting
- Beide kanten op
- Verversing
- Per aanroep; wijzigingen in Recruitee zijn meteen zichtbaar
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- Er komt een harde deadline aan. De Careers Site API vraagt om een token in de header, en Recruitee noemt 10 februari 2027 als de datum waarop dat verplicht wordt: aanroepen zonder die header geven vanaf dan een 401. Draait er een koppeling die vóór die aankondiging is gebouwd, dan valt je vacatureoverzicht op die dag stil zonder dat er iets aan je site is veranderd. Controleer dat nu, niet in februari.
- Het token heeft de rechten van de persoon die hem maakt. Recruitee zegt het zelf: een token geeft dezelfde rechten als de gebruiker in de web- of mobiele applicatie, en het is niet mogelijk om het toegangsniveau lager te zetten. Maak hem dus niet aan onder het account van de directeur, maar onder een account dat alleen doet wat nodig is, en houd hem op je server.
- Er zijn twee API’s en je wilt bijna altijd de eerste. De Careers Site API kijkt vanuit de kandidaat: gepubliceerde vacatures bekijken en solliciteren. De gewone API kijkt vanuit de recruiter en kan veel meer, waaronder kandidaten doorzoeken. Voor een openbare website is de eerste de juiste, en wat de token dekt is ook precies dat rijtje.
- De XML-feed en de widget vallen erbuiten. Het token van de Careers Site API dekt de feed voor vacaturebanken en de jobs-widget niet; dat zijn losse dingen. Gebruik je de feed om je vacatures naar Indeed of een ander platform te sturen, dan verandert daar niets, maar reken er niet op dat dezelfde sleutel overal werkt.
Recruitee koppelen
Wat je moet weten voor je begint.
Wat is Recruitee?
Recruitee is een wervingssysteem, tegenwoordig onderdeel van Tellent. Je zet er je vacatures in, publiceert ze naar vacaturebanken, volgt kandidaten door de selectiestappen en werkt er met je team aan samen.
Bij Recruitee hoort standaard een careers site: een vacaturepagina op een adres van hen, met de opmaak die je daar instelt. Dat werkt, en het is de reden dat veel bedrijven hun vacatures niet op hun eigen site hebben staan maar op een subdomein van de leverancier.
Daar zit voor werkgeversmerk en vindbaarheid het probleem, en daar is deze koppeling het antwoord op.
Hoe de koppeling met je website werkt
Recruitee heeft hier een aparte API voor gemaakt, de Careers Site API, en die omschrijven ze als: de vacatures van een bedrijf bekijken en nieuwe kandidaten toevoegen, vanuit het perspectief van de kandidaat. Ze noemen zelf als gebruik: een lijst met vacatures tonen of het sollicitatieformulier op je eigen site bouwen.
De API zit op het adres van je eigen bedrijf met /api erachter. Er zijn drie endpoints en meer heb je niet nodig. Een lijst met gepubliceerde vacatures, te filteren op afdeling of label. Eén vacature opvragen. En het aanmaken van een kandidaat bij een vacature.
Dat laatste is het punt waar het echt anders wordt dan een doorlink: een sollicitatie via deze API is een echte sollicitatie. Recruitee zegt het zo: een kandidaat aanmaken via deze API is alsof de kandidaat solliciteert, en het zet alles in gang wat daarbij hoort, zoals de bevestigingsmail.
Het sollicitatieformulier
Standaard zijn naam, telefoon, e-mail en cv verplicht. Behalve naam en e-mail kun je die eisen per vacature uitzetten in de instellingen van het sollicitatieformulier.
Dat is meer waard dan het klinkt. Een cv verplicht stellen kost je kandidaten bij functies waarvoor mensen er geen hebben liggen; voor een vakantiekracht of een productiemedewerker is een formulier van drie velden het verschil tussen twintig en twee reacties. Omdat het per vacature instelbaar is, kun je dat per functie afwegen.
De screeningsvragen die je in Recruitee instelt komen mee in het antwoord van de vacature-endpoint, met hun type, of ze verplicht zijn en in welke volgorde ze horen. Wij tekenen ze uit in je eigen formulier en sturen de antwoorden mee terug. Je hoeft ze dus niet twee keer te onderhouden.
Waarom vacatures op je eigen domein horen
Een vacature op een subdomein van je wervingssysteem is voor een zoekmachine een pagina van dat systeem. De vindbaarheid die je opbouwt, bouw je voor hen op.
Op je eigen site is het omgekeerd. Elke vacature krijgt een adres op je eigen domein, met jouw tekst over het team en de plek eromheen, en met gestructureerde data zodat hij in Google for Jobs kan verschijnen. Je kunt er vanaf je andere pagina’s naartoe linken, en een advertentie die erheen leidt landt op je eigen site in plaats van op die van een ander.
En er is een praktisch voordeel: wie op je vacaturepagina komt, ziet de rest van je site. Dat is precies wat je wilt bij werving, want iemand die twijfelt gaat kijken wat voor bedrijf je bent. Dat kan niet op een careers site die los van je merk staat.
Bijgewerkt op
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Kan ik mijn vacatures uit Recruitee op mijn eigen website zetten?
Ja, daar is de Careers Site API voor. Die geeft je gepubliceerde vacatures terug, te filteren op afdeling of label, en je kunt per vacature de details ophalen. Wij maken er een eigen pagina per vacature van op je eigen domein.
Kan iemand op mijn eigen site solliciteren?
Ja. Er is een endpoint om een kandidaat bij een vacature aan te maken. Recruitee behandelt dat als een echte sollicitatie, dus alles wat daarbij hoort gaat in gang, waaronder de bevestigingsmail aan de kandidaat.
Wat verandert er op 10 februari 2027?
Vanaf die datum zijn aanroepen zonder token verplicht voorzien van de header X-Careers-Sites-Token; zonder die header volgt een 401. Draait er een koppeling van vóór die aankondiging, controleer dan nu of het token erin zit.
Welke velden zijn verplicht bij een sollicitatie?
Standaard naam, telefoon, e-mail en cv. Behalve naam en e-mail kun je die eisen per vacature uitzetten in de instellingen van het sollicitatieformulier. Bij functies waarvoor mensen geen cv hebben liggen scheelt dat veel reacties.
Komen mijn screeningsvragen mee?
Ja. Die staan in het antwoord van de vacature-endpoint, met hun type, of ze verplicht zijn en op welke plek ze horen. Wij tekenen ze in je eigen formulier en sturen de antwoorden mee, zodat je ze maar op één plek onderhoudt.
Werkt een Recruitee-koppeling ook op WordPress?
Ja. De vacatures slaan we op als eigen berichttype in WordPress, zodat overzicht, filters en losse pagina’s werken zoals de rest van je site. De sollicitatie gaat vanaf de server naar Recruitee, zodat het token niet in de paginabron staat.
Let’s work together.
Vacatures op je eigen domein, sollicitaties in Recruitee.