> 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/application-integration-and-entitlement-data-extraction.md).

# Application Integration & Entitlement Data Extraction

### Application Integrations <a href="#app-integrations" id="app-integrations"></a>

The Third Party Applications tab in Integrations displays the current list of integrations:

<figure><img src="/files/I4JWn0iP3rNjWyX6D4u6" alt=""><figcaption></figcaption></figure>

### Integrating a new Application: <a href="#h_01hpzxnnktnf241s28vqsn3vy3" id="h_01hpzxnnktnf241s28vqsn3vy3"></a>

1. Click the “*Add integration*” button. Select the application you would like to setup. It will create an instance of the application in the list of integrated applications.

   <figure><img src="/files/mbhNNisrmGAHwjytlMkr" alt=""><figcaption></figcaption></figure>
2. A sidebar will open to set up the application integration. Here, you can add a description, assign primary and secondary owners, configure review settings, choose fulfilment options, and set up your preferred data extraction method. Refer to the 4th step for more information on different data extraction methods.\
   \
   **Note:** You must select a primary owner for the integration, but secondary owners are optional. Application owners will need to take action on access reviews and requests based on your default reviewer settings.\
   ![](/files/T1DlKyKFrrUcGyDh6wyT)
3. After setting up primary and secondary application integration owners, scroll to your newly added application and click on the "*Configure and Integrate"* ("<img src="/files/Jl0PvMIHlLpWU1PEIuko" alt="" data-size="line">" icon) under the "*Actions*" column (last column on the table) for that application. A sidebar corresponding to your application will open (refer to the below image):\
   \
   ![](/files/hXvnNlwCpmcsbzdNPZEs)
4. From here, you can configure your application using one of the following methods:
   1. **Manual upload** - You may also upload application identities and entitlements through a .CSV file upload. For more details, please refer to the [.CSV upload of entitlement data](/getting-started/setting-up-your-tenant/application-integrations/custom-application-integration-data-upload.md) for specific instructions on how to upload entitlements manually.
   2. **Automated upload using API -** You can upload data using our [Bulk APIs](https://developer.balkan.id/getting-started/introduction) with the help of an API key which will be provided to you. Please refer to the [application entitlement upload through Bulk API](https://developer.balkan.id/api-reference/entitlements/bulk-entitlements-upload-api-early-access) for specific instructions on uploading your application data through the API.
   3. **Direct integration** - Provide your application integration credentials to set up a direct connection between BalkanID and the application in question. For more details on a specific integration, please refer to the [Direct Application Integrations](/getting-started/setting-up-your-tenant/application-integrations/direct-application-integration.md) section of our documentation. For an in-depth example, check out the [Atlassian Jira](/getting-started/setting-up-your-tenant/application-integrations/direct-application-integration/atlassian-jira-application-integration-setup.md) integration.
   4. **SCIM integration** - Provide SCIM server credentials to set up a SCIM connection between BalkanID and the application.
5. Once done, click on the "*Save Changes*" button. Your integration will process and extract your data in a few minutes.
6. You can view your application entitlement data once the status of application integration is "*Connected*" and you see the "*Data Available*" message in the table.

In addition to the basic configurations, the integrations setup section can be used to setup multi-level review, fulfillment options (SSO provisioning, SaaS direct provisioning, ticket creation, SCIM, webhooks, playbooks) as well as integration sync options (direct configuration, file upload, API, SCIM). Contact your customer support representative at BalkanID for a detailed walkthrough.

![](https://support.balkan.id/hc/article_attachments/24103029180315)

Please reach out to a BalkanID team member if you have any questions or need assistance configuring an integration. We are always available to help.


---

# 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 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/application-integration-and-entitlement-data-extraction.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.
