# ChartHop setup

ChartHop connects through the **unified HRIS connector**. This page covers the
ChartHop-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 organization segment of your ChartHop URL |
| **API token** | Settings → Apps |

## Before you start

You need **admin permissions** in your company's ChartHop instance, or a
colleague who has them.

> **warning**

These steps reflect Axiad's current understanding of ChartHop's configuration.
Because ChartHop 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

Your subdomain is the organization segment of your ChartHop URL. If your URL is
`https://app.charthop.com/acme/home`, the subdomain is `acme`.

![The ChartHop URL showing the organization segment](/img/connectors/hr/providers/7868923-df39cd77cb.jpg)

## Step 2 — Create an API token

1. Go to **Settings → Apps → All apps** and install the integration app.

2. Generate an API token with the **Owner** access level.

   :::caution Owner access is required

   A token at a lower access level authenticates but cannot read the full
   population, so the connector goes healthy and returns a partial estate.

   :::

3. Save the token.

## Step 3 — Connect in Mesh

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

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

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

## Troubleshooting

| What you see | Likely cause | Fix |
|---|---|---|
| Only some employees arrive | The token is below **Owner** access level | Generate a new token at owner level and reconnect |
| Authentication fails | The full URL was entered instead of the organization segment | Use just the segment, for example `acme` |