Identity en access management

BuddeeHR Entra ID koppeling: Microsoft 365-account uit het dienstverband in Buddee

Met een koppeling tussen BuddeeHR en Microsoft Entra ID krijgt elke nieuwe medewerker in Buddee automatisch een Microsoft 365-account, met functie, afdeling, locatie en leidinggevende uit Buddee. Eindigt het dienstverband in Buddee, dan wordt het account na de laatste werkdag geblokkeerd, en het nieuwe werkadres gaat terug naar Buddee zodat de medewerker daar met Microsoft kan inloggen.

Bespreek je koppeling Zo werkt de koppeling

Geschreven door Marcel van Beek, oprichter en integratiespecialistLaatst bijgewerkt: 9 november 2026

Wat de koppeling doet

Werkgevers met HR in Buddee en Microsoft 365 voor mail en Teams maken accounts aan op basis van een mail van HR. Stagiairs en uitzendkrachten krijgen soms een volledige licentie, en na een vertrek blijft een account weken actief omdat niemand IT heeft ingelicht.

HR maakt de medewerker aan in Buddee met dienstverband, startdatum en positie.
KoppelHet maakt het account in Entra ID aan met de afgesproken naamgevingsregel, en zet functie, afdeling, locatie en leidinggevende.
Het soort dienstverband bepaalt groepen en licentie. Een stagiair krijgt iets anders dan een medewerker in vaste dienst.
Het nieuwe werkadres gaat terug naar Buddee, zodat de uitnodiging voor Buddee naar het zakelijke adres gaat.
Na de einddatum van het dienstverband wordt de aanmelding geblokkeerd; de licentie vervalt na de afgesproken termijn.

Heen: Gebruiker met naam, personeelsnummer en werkadres · Functie, afdeling en locatie · Leidinggevende · Soort dienstverband · Werkadres terug naar Buddee
Terug: Werkadres als zakelijk e-mailadres in Buddee

Waar je op let bij BuddeeHR en Microsoft Entra ID

Buddee biedt inloggen met Microsoft, maar dat is alleen aanmelden in Buddee. Er komt geen account mee in Entra ID. De koppeling draait het om, het account ontstaat uit Buddee, en daarna logt de medewerker met datzelfde account in op Buddee.
Buddee kent zes soorten dienstverband, onder meer stagiair, zzp'er, uitzendkracht, DGA en vrijwilliger. Die gaan mee naar Entra ID, zodat groepen en licenties per soort te regelen zijn en een vrijwilliger geen volledige Microsoft 365-licentie krijgt.
In Buddee heeft een medewerker naast een leidinggevende ook een indirect leidinggevende, een HR-manager en een buddy. Alleen de directe leidinggevende wordt manager in Entra ID; de buddy zetten we niet als manager, ook al is die bij de start vaak het eerste aanspreekpunt.
Buddee bewaart functie, afdeling, locatie en leidinggevende als posities met een begin- en einddatum. Een overstap naar een andere afdeling per de eerste van de maand wordt in Entra ID op die datum doorgevoerd, niet op de dag dat HR hem invoert.
Buddee bouwt de achternaam op uit eigen naam en partnernaam, volgens de naamstelling die de medewerker kiest. Voor het e-mailadres gebruikt KoppelHet de eigen naam, zodat een adres niet verandert als iemand later de naamstelling aanpast.
De Buddee-API werkt met een gewoon gebruikersaccount. Is dat het account van een medewerker, dan blokkeert de koppeling bij diens vertrek haar eigen toegang. KoppelHet gebruikt daarom een apart Buddee-account dat buiten de koppeling naar Entra ID valt.
Met meerdere bedrijven in één Buddee-omgeving zijn personeelsnummers alleen per bedrijf uniek. KoppelHet zet het bedrijf voor het nummer, en de bedrijfsnaam komt in Entra ID, zodat dynamische groepen per BV kunnen.

Deze koppeling hoort ook bij in-, door- en uitstroom.

Hoe we het bouwen en beheren

De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.

Implementatie, architectuur en compliance

Implementatie en prijs

Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.

Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.

Prijsindicatie · Basis

Veelgestelde vragen

Is inloggen met Microsoft in Buddee niet genoeg?

Nee. Dat regelt alleen hoe iemand in Buddee inlogt. Het Microsoft-account moet er dan al zijn, en daar zorgt deze koppeling voor.

Krijgen uitzendkrachten en vrijwilligers ook een account?

Dat bepalen jullie per soort dienstverband. Wie in Buddee staat, kan een account met beperkte groepen krijgen; wie er niet in staat, blijft buiten de koppeling.

Werkt dit ook met Active Directory on-premise?

Ja, via een klein programma in jullie netwerk. Dat kan later als uitbreiding; we beginnen met Entra ID.

Technische details voor IT

Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.

Buddee wordt gelezen via de REST API op api.buddee.nl: employees, employments (type, start_date, end_date; filters active_or_future en future) en positions (job_id, department_id, location_id, manager_id, cost_center_id met start_date en end_date). Wijzigingen via filters zoals gte: op updated_at; webhooks staan niet in de documentatie.
Authenticatie met Basic Auth (e-mail en wachtwoord van een Buddee-gebruiker) op /auth/token, daarna een JWT-accesstoken als Bearer. Het werkadres gaat terug via PUT /employees/{id} (work_email); de uitnodiging via POST /employees/{id}/invite?type=business.
Naar Entra ID schrijven we via Microsoft Graph. Velden onder meer employeeId, givenName, surname, userPrincipalName, mail, mailNickname, jobTitle, department, officeLocation, manager, companyName, employeeType, employeeHireDate, usageLocation en accountEnabled.

Welke velden overgaan

De belangrijkste velden. De volledige mapping stellen we per klant vast.

Veld in BuddeeHR	Veld in Microsoft Entra ID	Toelichting
`company_id + number`	`employeeId`	Het personeelsnummer is alleen binnen één bedrijf uniek
`first_name`	`givenName`
`composed_last_name_prefix + composed_last_name`	`surname`	Volgens de naamstelling in Buddee
`Naamgevingsregel`	`userPrincipalName, mail en mailNickname`
`Functie (job_id)`	`jobTitle`
`Afdeling (department_id)`	`department`
`Locatie (location_id)`	`officeLocation`
`manager_id`	`manager`
`Bedrijf (company)`	`companyName`
`employment.type`	`employeeType`	employee, intern, self-employed, agency_worker, dga of volunteer
`employment.start_date`	`employeeHireDate`
`employment.end_date`	`accountEnabled = false`
`userPrincipalName`	`work_email`	Terugweg naar Buddee

Bronnen

BuddeeHR Entra ID koppeling: Microsoft 365-account uit het dienstverband in Buddee

Wat de koppeling doet

Waar je op let bij BuddeeHR en Microsoft Entra ID

Hoe we het bouwen en beheren

Implementatie en prijs

Veelgestelde vragen

Is inloggen met Microsoft in Buddee niet genoeg?

Krijgen uitzendkrachten en vrijwilligers ook een account?

Werkt dit ook met Active Directory on-premise?

Technische details voor IT

Welke velden overgaan

Gerelateerd

BuddeeHR → Active Directory

BuddeeHR → AllSolutions

BuddeeHR → Arbodienst (SIVI)

BuddeeHR → Exact Online

Welke systemen wil je koppelen?