Skip to content
English
  • There are no suggestions because the search field is empty.

Setting up the iTrent integration

How a System Admin connects iTrent so hired candidates can be sent across to your HR and payroll system.

How a System Admin connects iTrent so hired candidates can be sent across to your HR and payroll system.

The iTrent connection sends a new starter from Recruit into iTrent, the MHR HR and payroll system. Data goes one way only, from Recruit to iTrent. Recruit does not read vacancies, employees or anything else back from iTrent. A System Admin sets the connection up once. After that, HR or a System Admin sends each hired candidate across, or Recruit does it automatically when the candidate reaches the Hired stage.

Who can do what

  • System Admin: connects iTrent, turns it on or off, resets it, and opens the Field Mappings page from the iTrent card.
  • HR and System Admin: send a candidate to iTrent, cancel a sync that is running, retry a sync that failed, and save changes on the Field Mappings page.
  • Everyone else who can open a candidate: sees the sync history on the candidate, read only, once at least one sync has happened. They get no buttons.

HR cannot open Integrations in Settings, so only a System Admin can reach the iTrent card and the connection details.

Before you start

Ask your iTrent administrator or MHR consultant for these:

  • The Endpoint URL.
  • Your Organisation Code.
  • A username and password that Recruit uses to send data to iTrent.
  • A second username and password that iTrent uses when it sends its replies back to Recruit. The reply address itself is set up on the iTrent side.

Onboarding does not need to be switched on. The candidate needs a submitted application. A candidate whose application is still a draft cannot be sent, and the iTrent card is not shown for it.

Connect iTrent

  1. Go to Settings, then Integrations. iTrent is listed under the HRIS heading.
  2. On the iTrent card, select Configure. The dialog is titled Configure iTrent.
  3. Under Connection, fill in Endpoint URL (it must start with https://), Organisation Code, API Username and API Password. All four are required.
  4. Under Webhook Credentials, enter a Webhook Username and Webhook Password. Both are required. iTrent must present this username and password when it replies to Recruit, and Recruit rejects replies that do not match.
  5. Under Options, switch on Auto-trigger on hire if Recruit should send candidates automatically.
  6. Select Save Configuration. The message "Configuration saved successfully" appears. The first time you save, the iTrent switch on the card turns on by itself and the badge changes from Pending to Configured.

If a required box is empty, the dialog says "This field is required". A bad address gives "Please enter a valid URL" or "URL must start with https://". Passwords you have already saved show as hidden, and leaving them blank keeps the saved value.

When Auto-trigger on hire is on and the connection is switched on, Recruit starts a sync as soon as an application is moved into a stage of the Hired type, using the candidate's most recent offer. If your organisation has more than one HR system switched on with automatic sending, iTrent is tried first, then Cintra, Cascade HR and HiBob, and only the first match runs.

Switch it off or reset it

Use the switch on the iTrent card to stop all sending, including automatic sending, without losing the saved details. Syncs already in the history stay visible.

Choosing Reset on the card and confirming with Reset Configuration deletes all saved iTrent settings, including the field mappings. This cannot be undone, so you would need to enter the connection details again.

Related articles