Skip to main content
View as MarkdownOpen in ChatGPTOpen in Claude

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.

You finish with two values:

ValueWhere it comes from
SubdomainThe organization segment of your ChartHop URL
API tokenSettings → Apps

Before you start​

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

Third-party product

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

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.

    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, 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.

Troubleshooting​

What you seeLikely causeFix
Only some employees arriveThe token is below Owner access levelGenerate a new token at owner level and reconnect
Authentication failsThe full URL was entered instead of the organization segmentUse just the segment, for example acme