> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ChartHop

*Lumos partners with Merge.dev for the ChartHop integration. Review the Merge.dev documentation for integration requirements.*

## After this article

You'll be able to connect ChartHop to Lumos and use it as a source of user data (HRIS) for visibility and access workflows. ChartHop is a Merge.dev-powered HRIS integration.

## Capabilities

| Functionality | Type | Sync | Provision | Description |
| - | - | - | - | - |
| Users | Account | Yes | Not documented | Employee and user records synced as a source of user data |

## Required plan and roles

* **ChartHop role:** you need Admin permissions in your company's ChartHop instance, or someone has to share their access with you.

## Read-only access vs provisioning

**Is read-only possible?** Yes. ChartHop connects as a Merge.dev-powered HRIS source, and Lumos syncs employee and user records from it for visibility and access workflows. No capability to create, suspend, or remove ChartHop accounts from Lumos is documented, so treat this as a read-only source of user data.

**What read-only requires.** Admin permissions in your company's ChartHop instance, or access shared by someone who has them, then follow the steps below to connect through the Merge.dev-powered flow.

**Watch out for.** Because Lumos partners with Merge.dev for this integration, the underlying credential and its scope are handled inside the Merge.dev connection pop-up rather than a Lumos-visible token, so there is no separate read-only credential to choose. Consult Merge.dev's own documentation if you need details on what that pop-up grants.

## Instructions

**Phase 1: Connect in Lumos**

1. Click the ChartHop card in your Lumos integrations (reconnect an existing card or add a new one).
2. Click the **Connect ChartHop** button.
3. Follow the instructions in the pop-up that appears to finish connecting the integration.

**Phase 2: Set as a source of user data**

1. Once you've connected the integration, you'll probably want to set it as a source of user data in Lumos.
2. See the Source of Truth settings documentation for the different source of truth options.

## Troubleshooting

**Connection requires Admin access.** Make sure you have Admin permissions in your company's ChartHop instance. If you don't, ask someone with Admin access to share their access or connect on your behalf.
