# iTrent setup

iTrent connects through the **unified HRIS connector**. This page covers the
iTrent-side configuration you complete first. Once it's done, add the connector
in Mesh by following [Connect your HR system](../connect-your-hr-system.md).

You finish with four values:

| Value | Where it comes from |
|---|---|
| **Web server name** | Your iTrent URL |
| **Connection name** | Your iTrent URL |
| **Username** | The API user you create |
| **Password** | Set on that user |

## Before you start

You need **administrator permissions** in your company's iTrent instance.

> **warning**

These steps reflect Axiad's current understanding of iTrent's configuration.
Because iTrent is a third-party product, there may be variations between your
experience and what this guide describes, depending on the version in use and
recent updates.

If you find a significant difference, or anything that doesn't make sense, let
us know through Axiad support.

## Step 1 — Create a function access profile

1. Search for the **Function Access Details** page.
2. Add a new entry with:

   | Field | Value |
   |---|---|
   | Name | Anything recognizable, for example `WEBSERVICES` |
   | Access type | **Web Services** |
   | Start date | Today; no end date needed |
   | Status | Active |

   ![The Function Access Details page with a web services profile](/img/connectors/hr/providers/8138871408-3ee4ce9f02.jpg)

## Step 2 — Create a user bound to it

1. Search for the **User Details** page and add a new user.
2. Set:

   | Field | Value |
   |---|---|
   | Username | Your choice |
   | Access type | **Function Access** |
   | Function access name | The profile from Step 1 |

3. Set a password and save.

   ![The User Details page with function access selected](/img/connectors/hr/providers/8138871408-707a632742.jpg)

## Step 3 — Grant API access areas

1. Go to the **Web Services User Control Details** page.
2. Find the user you just created.
3. Select the API access areas the connector should read, and save.

   ![The Web Services User Control Details page with API areas selected](/img/connectors/hr/providers/8138871408-a00734f809.jpg)

> **caution**

A user with the function access profile but no API access areas authenticates
successfully and reads nothing. If your first collection completes empty, this
step is the one to check.

## Step 4 — Find your web server and connection names

Both are in the URL you use to reach iTrent. Take them from the address bar
rather than typing them from memory — they differ between iTrent customers.

## Step 5 — Connect in Mesh

Follow [Connect your HR system](../connect-your-hr-system.md), choose iTrent in
the connection window, and supply the web server name, connection name, and the
API user's credentials.

## After connecting

The connector appears in your connectors list with **Health: Initializing**
while the first collection runs, then moves to **Good**. Access is
**read-only**: Mesh does not write back to iTrent.

If it doesn't come online, see [Troubleshoot HR
connectors](../troubleshoot-hr-connectors.md).

## Troubleshooting

| What you see | Likely cause | Fix |
|---|---|---|
| The connector authorizes but collects nothing | No API access areas are selected for the user | Complete Step 3, then re-run the collection |
| Authentication fails | The user's access type is not **Function Access**, or the profile is not web services | Re-check Steps 1 and 2 |
| The connection cannot be established | The web server or connection name was mistyped | Copy both from your iTrent URL |