# Manual user data upload

## Steps to manually upload user data <a href="#h_01hq00h9yrp58dadwabtj213t9" id="h_01hq00h9yrp58dadwabtj213t9"></a>

1. To perform a manual .CSV upload in the application, you will need a CSV file containing user data (including employees, contractors etc). All HR / payroll / employee source of truth tools should allow you do to download this data. Please ensure that your data is formatted as per the format attached at the bottom of this page.

   <table data-header-hidden><thead><tr><th></th><th></th><th></th><th></th><th width="178.48828125"></th><th></th><th></th><th></th><th></th><th></th><th></th><th></th><th width="185.21484375"></th><th></th><th width="304.91796875"></th><th></th><th width="298.62890625"></th></tr></thead><tbody><tr><td><strong>User ID</strong></td><td>Full Name</td><td>First Name</td><td>Last Name</td><td>Work Email</td><td>Department</td><td>Title</td><td>Start Date</td><td>End Date</td><td>Employment Type</td><td>Organization</td><td>Manager</td><td>Manager Work Email</td><td>Source User ID</td><td>BalkanID Roles</td><td>Metadata Version</td><td>Metadata</td></tr><tr><td>12345</td><td>John Q</td><td>John</td><td>Q</td><td>john.q@acme.com</td><td>Ops</td><td>Engineer</td><td>01/01/2002</td><td></td><td>Full time</td><td>Security</td><td>Jane Doe</td><td>jane.doe@acme.com</td><td>111111</td><td>reviewer</td><td>v1</td><td>{"employee":"John Q","role id":"1","location":{"address":"123 Main Street, Office Suite 111, Anytown, USA 12345"}}</td></tr><tr><td>67890</td><td>Jane Doe</td><td>Jane </td><td>Doe</td><td>jane.doe@acme.com</td><td>Ops</td><td>Manager</td><td>01/01/2002</td><td></td><td>Full time</td><td>Security</td><td></td><td></td><td>222222</td><td>reviewer, risk manager, administrator</td><td>v1</td><td>{"employee":"Jane Doe","role id":"2","location":{"address":"123 Main Street, Office Suite 222, Anytown, USA 12345"}}</td></tr></tbody></table>

   \
   **Required fields:** Work email, Start date&#x20;
2. Metadata is a JSON object and has a corresponding Metadata Version. Metadata Versions and their respective allowed fields which are currently supported -
   1. "v1"
      1. "location" - JSON with the following fields:
         1. "address" - String
      2. "manager id" - String
      3. "manager name" - String
      4. "employee" - String
      5. "role id" - String
      6. "app" - String (Internal use)
      7. "correlation id" - String (Internal use)
      8. "tenant" - String (Internal use)
      9. "timestamp" - String (Internal use)
3. Even though the "Internal use" fields are supported, they are meant for internal use and are only supported for the purpose of being able to download from an Employee integration (like Merge or Google) and then upload after edits to the Employee without losing relevant information about the original extraction from the integration.
4. Once you have processed your data and converted it into the suitable format, proceed to upload the .CSV file in the *Configure* > *Users* page. Click on "*Bulk Upload".*<br>

   <figure><img src="/files/bgLplitaupeJHW7TxIHZ" alt=""><figcaption></figcaption></figure>
5. You will be able to see a side screen as shown below. Under the *Employees Upload* section, upload your formatted .CSV file. <br>

   <figure><img src="/files/ukaEQZGmomZnMPTrnhIU" alt=""><figcaption></figcaption></figure>
6. You will be intimated regarding the status of the upload through the snackbar on the top-right of the screen while the BalkanID environment ingests your data and updates your tenant.

<figure><img src="/files/aQr6JaXVsb9elI8nvKCR" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
If you need help, contact <support@balkan.id>.
{% endhint %}

{% file src="/files/ygCWJdYgmNpLatOx1lbu" %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.