Connect Ramco HCM to Microsoft Entra ID

Connect Ramco HCM to Microsoft Entra ID

Connect Ramco HCM to Microsoft Entra ID

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

Key takeaways

  • Ramco HCM stays your source of truth; Joinly applies every joiner, mover and leaver to Entra ID automatically over the Ramco HCM API.

  • Joinly maps Ramco’s organisation structure — country, employing entity, department and role — to the right Entra ID groups and licences, something a raw SCIM feed can’t do on its own.

  • Multi-country payroll is handled explicitly: employees engaged under different countries in the same Ramco tenant are placed in the correct groups without cross-country leakage.

  • Country-specific payroll and statutory identifiers stay out of the username and public attributes, so a Gulf or APAC national ID never ends up in the UPN.

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

Ramco HCM

Joiner

Mover

Leaver

Microsoft Entra ID (formerly Azure AD)

Quick facts

Source system

Ramco HCM (employee master and Global Payroll)

Target system

Microsoft Entra ID (formerly Azure AD)

Connection method

Ramco HCM API → Entra ID

Supported events

Joiner, mover, leaver (incl. rehire and cross-country transfer)

Synced attributes

Name, email / UPN, department, job title, manager, employing country / entity, start and end date

Authentication

Secure API credentials over HTTPS (no basic auth in the browser)

Real-time or batch

Frequent sync, multiple times per day

Compliance

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

How does Joinly sync Ramco HCM to Microsoft Entra ID?

Joinly reads each HR change in Ramco HCM through the API and applies it to the matching Entra ID account automatically. Ramco HCM holds the authoritative employment record, so it is the starting point for each identity action.

  1. Joiner. HR completes the hire in Ramco HCM. Joinly reads the new employee record and determines the role from attributes like department, job title and employing country. It then creates the account in Entra ID, assigns the right licences and maps the person into the correct groups.

  2. Mover. When someone changes position, department or employing country in Ramco HCM, 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 termination date recorded in Ramco HCM, Joinly disables the Entra ID account automatically. There are no orphaned accounts left active after someone has left, and a soft-delete grace window gives IT time to reassign mailboxes and files.

Example: A multinational running Ramco HCM hires an operations analyst in its Singapore entity. Joinly reads the new record, creates the Entra ID account, assigns an Office E3 licence and adds the analyst to the SG-Operations group. When that analyst later transfers to the Dubai entity, Joinly swaps the country groups the same day and keeps the same account rather than creating a duplicate — while the Gulf payroll identifier that Ramco holds for statutory reasons never touches the UPN.

What manual user management costs

Without automation, every account starts as a Ramco HCM ticket or a line in a spreadsheet that IT works through by hand. Entra’s generic API-driven inbound provisioning can move attributes across once someone builds and feeds the SCIM endpoint, but it maps roles to groups through manual rules and has no Ramco-aware logic — so the part that actually decides access still falls to people.

  • 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 position or transfer between countries, 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 long after the person has left.

Joinly vs. Entra API-driven inbound provisioning

There is no pre-built Entra provisioning app for Ramco HCM the way there is for SuccessFactors or Workday, so the native path is Entra’s generic API-driven inbound provisioning that a partner has to build and map by hand. Here’s how the two compare for a Ramco-driven setup.


Joinly

Entra API-driven inbound provisioning

Source

Reads the Ramco HCM API directly

Needs a custom SCIM client built and fed from Ramco

Role-to-group mapping

Built in, rule-based on Ramco org structure

Manual attribute mapping; no role-to-group out of the box

Multi-country payroll

Explicit rules per employing country / entity

Flat attribute flow; country logic is yours to build

Cross-country transfer

Updates the same account and swaps groups

Risk of duplicate or stale account without custom logic

Licence assignment

Driven by role / attributes

Manual or group-based only

On-premise AD

Yes, own agent plus the native Microsoft agent

Provisioning agent required, limited mapping

Audit trail

Per-action logging tied to the HR source

Limited

Watch-outs when connecting Ramco HCM to Microsoft Entra ID

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

  • Multi-country payroll in one tenant. Ramco’s strength is Global Payroll across APAC, ANZ, India and the Middle East, so a single tenant commonly holds employees engaged under many countries with different statutory contexts. A naive rule can map the wrong country context to a group. Joinly builds explicit rules from the employing country and entity, so each person lands in the right groups regardless of where their payroll runs.

  • Country-specific statutory identifiers. Employees in the Gulf and across APAC carry country-specific payroll and statutory identifiers that Ramco holds for compliance. These must never leak into the UPN, display name or other public directory attributes. Joinly maps only the attributes you choose and keeps statutory identifiers out of anything user-facing.

  • Cross-country transfers and global assignments. A transfer between countries can change the employing entity while the person stays the same individual. A naive sync can create a second account. Joinly keeps a single, stable account and swaps the groups and licences that the new country requires.

  • UPN format with duplicate names. Across a large multinational workforce, two employees regularly share a name. A naive UPN rule produces collisions. Joinly applies custom transformation rules — a suffix, country code or controlled tiebreaker — so every UPN is unique and predictable from day one.

  • Mapping Ramco org structure to Entra groups. Country, employing entity, department and role 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.

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 Ramco HCM 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 an international airline group with around 7,000 employees — flight crew, ground operations, engineering and head-office staff — running Ramco HCM with Global Payroll across hubs in India, Singapore and the Gulf. Identity never quite keeps up: every hire starts as a Ramco ticket that IT works through by hand in Entra ID, and with rostered crew, seasonal contracts and constant transfers between hubs the queue never empties. Worse, engineers who move from the Singapore entity to the Dubai one sometimes end up with a second account, and Gulf payroll identifiers occasionally surface where they shouldn’t.

Connect Ramco HCM to Microsoft Entra ID with Joinly and that work disappears. Joinly reads each HR change in Ramco at the source and acts on it automatically: new crew and ground staff have their account, Office licence and group access ready without a ticket, transfers between hubs swap the right country groups the same day and keep one stable account, and leavers are disabled on their termination date with a 30-day soft-delete grace window — all while statutory identifiers stay out of the directory.

“Cross-hub transfers used to spawn duplicate accounts and the Gulf payroll IDs kept leaking into places they had no business being. Now a transfer just swaps the groups, the account stays the same, and we can show the auditor exactly which Ramco change created every bit of access.” — Head of IT, international airline group

The outcome this setup is designed for: onboarding drops from days to zero touch, duplicate accounts from cross-country transfers 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 Ramco HCM 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 Ramco HCM to Microsoft Entra ID

Connect Ramco HCM to Microsoft Entra ID

Installation guide

Follow these steps to connect Ramco HCM 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 Ramco HCM integration in the Joinly marketplace

Open the Joinly marketplace and search for the Ramco HCM 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 Ramco HCM integration.

5. Follow the installation wizard

You may be redirected to integrations.joinly.app. Create an account there and enter your Ramco HCM connection details: your API endpoint and the API credentials issued for your tenant. We only ask for the information needed to establish a successful connection with Ramco HCM. All data is encrypted and stored securely.


Joinly installation wizard for entering Ramco HCM connection details


Enter your Ramco HCM API endpoint and 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 Ramco HCM fields.

Frequently asked questions

  • How do I map the manager? Reference the manager’s employee identifier in the mapping and Joinly resolves the link to the right manager automatically.

  • How do I handle multi-country employees? Map the employing country and entity to your groups; Joinly exposes those fields so you can drive access per country.

  • 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 Ramco HCM attributes using Liquid templates


Map Ramco HCM 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 Ramco HCM 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 Ramco HCM flows straight through to Entra ID. Finally, add a threshold workflow with the Entra soft delete action that runs a set period after the termination 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 Ramco HCM to Active Directory, or contact support at support@koppelhet.nl to request setup of the Joinly AD Agent.

Frequently asked questions

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

How does Joinly handle employees across multiple countries?
Joinly reads the employing country and entity on each Ramco record and applies your rules per country, so a person’s groups and licences match where they actually work — and a transfer between countries updates the same account rather than creating a duplicate.

Do country-specific payroll identifiers end up in Entra ID?
No. Joinly maps only the attributes you choose, so statutory and payroll identifiers Ramco holds for compliance stay out of the UPN, display name and other public directory attributes.

Which attributes sync from Ramco HCM to Entra ID?
Name, email / UPN, department, job title, manager, employing country / entity, and start and end date. Additional Ramco fields can be mapped via Liquid templates.

Is there a native Entra provisioning app for Ramco HCM?
No. Unlike SuccessFactors or Workday, Microsoft doesn’t ship a pre-built Entra inbound provisioning app for Ramco, so the native route is a custom API-driven SCIM feed you build and map yourself. Joinly reads the Ramco API directly and handles the role-to-group mapping and multi-country logic for you.

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 Ramco HCM to Active Directory guide.

Request installation support