> For the complete documentation index, see [llms.txt](https://docs.balkan.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.balkan.id/getting-started/setting-up-your-tenant/integrate-employee-data.md).

# Integrate employee data

## Getting started <a href="#getting-started" id="getting-started"></a>

BalkanID relies on specific HRIS data to effectively manage Identity Lifecycle and Governance activities. Essential data fields include names, emails, manager details, start and termination dates and department information. Uploading your employee data to BalkanID allows you to [map](https://docs.balkan.id/configurations-and-integrations/manual-uploads/mapping-identities-to-employees) accounts across your systems to employees for entitlement discovery, assigning access reviews and creating access requests. There are three ways to integrate your users to BalkanID -

* Direct Integration to your HR system
* Manual flat file (.CSV) upload
* Bulk API upload

This article will briefly cover the process for all three. They are given below:

1. [**Direct HRIS Integration**](https://docs.balkan.id/getting-started/setting-up-your-tenant/integrate-employee-data/integration-with-hris-system.md)**:**\
   Merge, our trusted integration partner, seamlessly connects your HRIS systems with BalkanID to ensure real-time accuracy of user data.
2. Adding users from the UI:\
   BalkanID provides a straightforward way to add individual user accounts directly through the user interface. This method is ideal for quickly onboarding a single user, performing tests, or when a full HRIS/IDP sync isn't immediately available for a new hire.
3. [**Manual .CSV Upload**](https://docs.balkan.id/getting-started/setting-up-your-tenant/integrate-employee-data/manual-user-data-upload.md)**:**\
   You can manually upload user data to integrate it into the BalkanID tenant.
4. [**Bulk API Upload**](https://developer.balkan.id/bulk-employees-upload-api-early-access-12828093e0)**:**\
   With BalkanID Bulk API (Early Access), administrators can automatically upload user data from their HRIS or Identity Provider. Bulk API (Early Access) is the most flexible way to integrate a custom application, HRIS, or Identity Provider with BalkanID that works with any customer specific business process, security constraint, or integration need. Customer is in full control of *application credentials*, *data extracted*, and *the schedule to update these integrations*.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.balkan.id/getting-started/setting-up-your-tenant/integrate-employee-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
