# Kallidus setup

Kallidus — formerly Sapling — connects through the **unified HRIS connector**.
This page covers the Kallidus-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 two values:

| Value | Where it comes from |
|---|---|
| **Subdomain** | The first label of your Kallidus URL |
| **API key** | Integrations → API Keys |

> **warning**

These steps reflect Axiad's current understanding of Kallidus' configuration.
Because Kallidus 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 — Find your subdomain

Enter only the first label of your URL, not the whole host. For
`company-name.saplingapp.io`, the subdomain is `company-name`.

![The connection window asking for the Kallidus subdomain](/img/connectors/hr/providers/5436556-ab1bf6a947.jpg)

## Step 2 — Create an API key

1. In Kallidus, open **Integrations**.

   ![The Kallidus integrations section](/img/connectors/hr/providers/5436556-192c0b9746.jpg)

2. Open **API Keys** and select **Create New Key**.

   ![The API Keys page with the create action](/img/connectors/hr/providers/5436556-2d96e2f00a.jpg)

3. Name the key, copy it, and save.

   ![The created API key](/img/connectors/hr/providers/5436556-86e3e64570.jpg)

## Step 3 — Connect in Mesh

Follow [Connect your HR system](../connect-your-hr-system.md), choose Kallidus in
the connection window, and supply the subdomain and API key.

![The connection window asking for the Kallidus API key](/img/connectors/hr/providers/5436556-3efa1ef2fe.jpg)

## 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 Kallidus.

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

## Troubleshooting

| What you see | Likely cause | Fix |
|---|---|---|
| Authentication fails | The full host was entered instead of the subdomain | Enter only the first label, for example `company-name` |
| The key is rejected | It was copied before being saved | Create a new key, then copy and save it |