Connect YouServe to Microsoft Entra ID

Connect YouServe to Microsoft Entra ID

Connect YouServe to Microsoft Entra ID

When someone joins, moves or leaves in YouServe, you want that change reflected in Microsoft Entra ID without anyone touching it by hand. To connect YouServe to Microsoft Entra ID, Joinly reads each HR change at the source — through the YouServe IAM API, the REST API Visma built specifically for identity and access management — and applies it automatically to the right account. YouServe HR Core stays your source of truth; Joinly is the engine that keeps every action accurate and traceable.

Key takeaways

  • YouServe HR Core (HR Core Business) stays your source of truth; Joinly applies every joiner, mover and leaver to Entra ID automatically via the YouServe IAM API.

  • Joinly maps YouServe organisatorische eenheden (organization units), job profiles and cost centers to the right Entra ID groups and licences — something a plain IAM-API export or CSV route can’t do on its own.

  • The IAM API returns an employee record per employment grouped by personCode; Joinly picks the newest record as the person identity, so multi-employment people get one clean, stable account.

  • The manager comes from the organizationUnits endpoint, not a role assignment, and Joinly resolves that hierarchy automatically — no manual manager lookup.

  • Every action is logged for a complete audit trail, aligned with NIS2 and ISO 27001.

YouServe

Joiner

Mover

Leaver

Microsoft Entra ID (formerly Azure AD)

Quick facts

Source system

YouServe (YouServe HR Core / HR Core Business)

Target system

Microsoft Entra ID (formerly Azure AD)

Connection method

YouServe IAM API (REST) → Entra ID

Supported events

Joiner, mover, leaver (incl. multi-employment, rehire, future contracts)

Synced attributes

Name, email / UPN, department (organization unit), job profile, manager, cost center, personCode, start and end date

Authentication

OAuth 2.0 Client Credentials (client_id / client_secret registered in the API Gateway, scoped to your tenant)

Real-time or batch

Frequent sync, multiple times per day

Compliance

ISO 27001, NIS2-ready, GDPR (EU data centre)

How does Joinly sync YouServe to Microsoft Entra ID?

Joinly reads each HR change from YouServe HR Core through the IAM API and applies it to the matching Entra ID account automatically. The IAM API is the interface Visma built specifically so identity systems can provision from HR Core, so it is the authoritative starting point for each identity action.

  1. Joiner. HR completes the hire in YouServe. Joinly reads the new person, employment and organization-unit records, groups them by personCode and determines the role from the organization unit, job profile and cost center. It then creates the account in Entra ID, assigns the right licences and maps the person into the correct groups — timed to the employment start date.

  2. Mover. When someone changes organization unit, job profile or department in YouServe, Joinly updates their group membership, permissions and licences to match. Access that no longer fits the new position is revoked, so permissions stay aligned with the actual job.

  3. Leaver. On the employment end date recorded in YouServe, Joinly disables the Entra ID account automatically. There are no orphaned accounts left active after someone has left, and because a person can hold more than one employment, access is only removed when the last active employment ends.

Example: A housing corporation hires a maintenance planner in YouServe with a start date next Monday, in its Vastgoedbeheer organization unit. Joinly reads the new records, waits until the start date, creates the Entra ID account, assigns a Microsoft 365 licence and adds the planner to the Vastgoed-Operations group. When that planner later picks up a second, small employment as an on-call duty officer, Joinly keeps the newest primary record as the identity, adds the extra group and leaves the single account and sign-in intact.

What manual user management costs

Without automation, every account starts as a YouServe export or a line in a spreadsheet that IT works through by hand. A flat-file route or a plain IAM-API pull can move attributes across, but it leaves role-to-group mapping, the personCode-based identity choice and the manager-from-organization-unit lookup to people — so the part that actually decides access still falls to your team.

  • Onboarding delays. New joiners wait for accounts, licences and group access while a ticket sits in a queue, losing productive days in their first week.

  • Permissions that don’t keep up (privilege creep). When movers change organization unit or job profile, old access often stays attached, so people accumulate rights they no longer need.

  • Forgotten offboarding. Accounts that aren’t disabled on time are both a security and audit risk, and unused licences keep costing money — and with multiple employments per person it is easy to disable an account while another employment is still active.

Joinly vs. a plain YouServe IAM-API export

A direct IAM-API pull or a flat-file export is a fine baseline, but it stops short of the part that actually decides access. Here’s how the two compare for a YouServe HR Core-driven setup.


Joinly

IAM-API export / middleware connector

Source

Reads the YouServe IAM API directly

Reads the YouServe IAM API or a file export

Role-to-group mapping

Built in, rule-based on organization unit, job profile and cost center

Not out of the box; scripted or manual

Multi-employment identity

Groups by personCode, picks the newest record as the person

Manual logic; wrong or dormant employment can sync

Manager resolution

Resolved from the organizationUnits endpoint automatically

Manual lookup; no role-assignment source in HR Core Business

Licence assignment

Driven by role / attributes

Manual or group-based only

On-premise AD

Yes, own agent plus the native Microsoft agent

Separate export/script required

Audit trail

Per-action logging tied to the HR source

Limited

Watch-outs when connecting YouServe to Microsoft Entra ID

A few YouServe-specific details decide whether this connection stays reliable at scale.

  • Multiple employments per person. The IAM API returns an employee record for each employment, grouped by personCode. A naive integration can sync a dormant or wrong employment as the identity. Joinly groups by personCode and picks the newest record as the person, so a second employment adds access instead of a duplicate account.

  • Manager comes from the organization unit, not a role. In HR Core Business the manager reference lives on the organizationUnits endpoint and the Assignments endpoint isn’t available. Joinly resolves the manager and hierarchy from organization units automatically, so the manager attribute in Entra ID is always correct.

  • The Person layer must be enabled. The persons endpoint only returns data once the Person layer is switched on in YouServe HR Core. Joinly’s onboarding checks this up front, so the connection isn’t silently returning empty person data.

  • Mapping organization units to Entra groups. Organisatorische eenheden, job profiles and cost centers don’t translate one-to-one to Entra ID groups. Joinly builds explicit mapping rules from those structures to the correct groups and licences, so role drives access rather than manual assignment.

  • UPN format with duplicate names. When two employees share a name, a naive UPN rule produces collisions. Joinly applies custom transformation rules — a suffix, personCode fragment or controlled tiebreaker — so every UPN is unique and predictable from day one.

Joinly handles each of these by default with custom mapping and transformation.

Always audit-ready

Every account action Joinly performs is logged: who was affected, when it happened, which access changed and which YouServe change triggered it. For NIS2 that matters directly: access can be traced back to an authorised HR source rather than an ad-hoc request. Joinly is ISO 27001 certified, runs in an EU data centre in Amsterdam, applies least-privilege by default, and is built to meet NIS2 and ISO 27001.

Example case

Picture a housing corporation with around 900 employees across a head office and several district teams, running YouServe HR Core as its HR core while its identity provisioning never quite keeps up. A nightly export handles the simple cases, yet on-call duty officers with a second small employment, internal transfers between district teams and future-dated contracts keep breaking it — people with two employments end up with the wrong one synced to Entra ID, and the manager attribute is often blank because it lives on the organization unit rather than a role.

Connect YouServe to Microsoft Entra ID with Joinly and that work disappears. Joinly reads each HR change through the IAM API and acts on it automatically: new hires have their account, Microsoft 365 licence and group access ready on their start date, transfers between district teams swap the right groups the same day, a second employment just adds access to one stable account, and leavers are disabled on their end date with a 30-day soft-delete grace window.

“Two employments on one person used to be the thing that broke every sync. Now an account is simply ready on the start date, a second employment just adds access, and we can show the auditor exactly which YouServe change created every bit of access.” — Head of IT, housing corporation

The outcome this setup is designed for: onboarding drops from days to zero touch, multi-employment errors stop entirely, and the team can walk into its next NIS2 assessment with a complete, source-backed audit trail.

More than a connector

A standalone YouServe to Entra ID connection is a good start, but identity rarely stops at one target. Joinly manages the complete chain from joiner to leaver across all your systems, with logging and governance built in. You review the exceptions; Joinly maintains the chain.

Schedule a demo

Installation manual

Installation manual

Connect YouServe to Microsoft Entra ID

Connect YouServe to Microsoft Entra ID

Installation guide

Follow these steps to connect YouServe to Microsoft Entra ID with Joinly. The entire cloud setup happens in the platform, with no scripts or local software required.

1. Create your account

Go to platform.joinly.app and create your account.

Note: charges may apply for using the platform after the trial period ends.


Joinly account creation screen at platform.joinly.app


Sign up at platform.joinly.app to get started.

2. Connect your Microsoft account

Open platform.joinly.app/settings/provisioning/idp-setup and connect your Microsoft tenant. Select the scopes you need. For provisioning you don’t need any additional scopes.


Joinly identity provider setup screen for connecting a Microsoft Entra tenant


Connect your Microsoft tenant and pick your scopes.

3. Import your existing accounts from Entra ID

Import all existing accounts from Entra ID at platform.joinly.app/settings/provisioning/entra-import. This gives Joinly a baseline of every account that already exists, so it can match people to their current account instead of creating duplicates.

4. Find the YouServe integration in the Joinly marketplace

Open the Joinly marketplace and search for the YouServe integration.

Don’t see your system listed? Get in touch at support@koppelhet.nl and we’ll help you out.


Joinly marketplace showing available HR integrations


Search the marketplace for the YouServe integration.

5. Follow the installation wizard

You may be redirected to integrations.joinly.app. Create an account there and enter your YouServe IAM API connection details: your tenant, and the OAuth 2.0 Client Credentials (client_id and client_secret) you registered as a Client Application in the Visma API Gateway. Make sure the Person layer is enabled in YouServe HR Core so the persons endpoint returns data. We only ask for the information needed to establish a successful connection with YouServe. All data is encrypted and stored securely.


Joinly installation wizard for entering YouServe IAM API connection details


Enter your YouServe tenant and OAuth client credentials in the wizard.

6. Configure your field mapping

Set up all your field mappings here. Templates support Liquid, so you can build your display name, UPN and other attributes dynamically from YouServe person, employment and organization-unit fields.

Frequently asked questions

  • How do I map the manager? Joinly resolves the manager from the organizationUnits endpoint automatically, so you don’t need a separate role-assignment source.

  • How do I handle multiple employments? Joinly groups records by personCode and picks the newest as the person identity; the other employments are exposed so you can add their access.

  • How do I prevent duplicate usernames? Use the generateUniqueUsername helper, which falls back to the next pattern when the first one is already taken:
    {{ generateUniqueUsername: “{firstName}.{prefix}.{lastName}”, “{initials}.{prefix}.{lastName}” }}


Joinly field mapping screen for YouServe attributes using Liquid templates


Map YouServe fields to Entra ID attributes with Liquid templates.

7. Configure the scheduled import

At platform.joinly.app/settings/import-configs, configure how often the import from YouServe should run.

8. Configure your workflows

Workflows are where Joinly turns each HR change into the right action in Entra ID. Create an onboarding (joiner) and offboarding (leaver) workflow with trigger-based execution, then an Identity updated workflow with a Create/update employee in Entra action so every change in YouServe flows straight through to Entra ID. Finally, add a threshold workflow with the Entra soft delete action that runs a set period after the employment end date (for example 30 days) to retire accounts safely.


Joinly workflow editor creating an employee onboarding workflow


Create a trigger-based onboarding workflow.


Adding the create or update employee in Entra action to a workflow


Add the create/update action, then set your matching strategy and field mapping.


Adding the Entra soft delete action to remove accounts on employee leave


Add the Entra soft delete action to retire accounts safely.

## AD on-premise support

Need to provision to an on-premise Active Directory as well? See our dedicated guide on connecting YouServe to Active Directory, or contact support at support@koppelhet.nl to request setup of the Joinly AD Agent.

Frequently asked questions

Does the YouServe to Microsoft Entra ID connection work in real time?
It runs as a frequent sync that updates multiple times per day, so changes in YouServe HR Core reach Entra ID quickly without waiting for a nightly batch.

How does Joinly handle a person with more than one employment?
The YouServe IAM API returns an employee record per employment, grouped by personCode. Joinly picks the newest record as the person identity and exposes the other employments, so a second employment adds access without creating a duplicate account or breaking sign-in.

Where does the manager attribute come from?
In HR Core Business the manager reference lives on the organizationUnits endpoint rather than a role assignment. Joinly resolves the manager and hierarchy from organization units automatically, so the manager attribute in Entra ID is always populated.

Which attributes sync from YouServe to Entra ID?
Name, email / UPN, department (organization unit), job profile, manager, cost center, personCode, and start and end date. Additional fields can be mapped via Liquid templates.

What do I need to connect to the YouServe IAM API?
OAuth 2.0 Client Credentials — a client_id and client_secret registered as a Client Application in the Visma API Gateway and scoped to your tenant — and the Person layer enabled in YouServe HR Core so the persons endpoint returns data.

Does Joinly also support AD on-premise or hybrid provisioning?
Yes. Joinly has its own AD on-premise agent and also supports the native Microsoft Entra provisioning agent, so you can provision users to your on-premise AD environment as well. See the YouServe to Active Directory guide.

Request installation support