# Integrating with Keka HR

[Prerequisites](#prerequisites)

[Keka HR Setup](#sapling-setup)\
   [Locating and Generating New API Keys](#locating-and-generating-new-api-keys)

[Drivetrain Setup](#sapling-setup-1)\
   [Setting up Keka HR Integration](#locating-and-generating-new-api-keys-1)

## Prerequisites

To connect Keka HR to Drivetrain, you need:

* An active Keka HR account
* Global-Admin privileges on Keka HR
* Admin privileges in Drivetrain

## Keka HR Setup <a href="#sapling-setup" id="sapling-setup"></a>

Drivetrain supports in-built integration with Keka HR. You would need to generate and enter API Keys from an account with administrator access to get started.

{% hint style="info" %}
Please note Keka's API access is currently in a closed beta phase and requires your account to include the API & Webhooks Add-On, which may have associated costs. Please reach out to <support@keka.com> to inquire about the status of this add-on with your account if it is not already enabled.
{% endhint %}

### Locating and Generating New API Keys <a href="#locating-and-generating-new-api-keys" id="locating-and-generating-new-api-keys"></a>

1. Navigate to **Settings** by selecting the gear icon in the upper left-hand corner of the page.
2. Under **Integrations and Automation** navigate to the **API Access** tab.
3. Enable API Access if you have not yet done so.
4. Copy the **Client Id** and **Client Secret** as it will be displayed only once, and they are mandatory for accessing the API.&#x20;

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

5. Create an API Key by selecting the **Create key** button, enter the name as "Drivetrain Integration" and select an expiry date (preferably a year or more from the day you are creating).&#x20;
6. Select the necessary scopes you need for the implementation and copy the **API key** and store it in a secure document along with Client ID and Client Secret.&#x20;

<figure><img src="/files/7nzUFtTE3HGIsIex6uGR" alt=""><figcaption></figcaption></figure>

7. Get the subdomain of your Keka HR account, for example if you login keka at mycompany.keka.com then your subdomain is "**mycompany**"

{% hint style="info" %}
Please note the following details are required for setting up Keka HR:

1. Client ID
2. Client Secret
3. API Key
4. Subdomain
   {% endhint %}

## Drivetrain Setup <a href="#sapling-setup" id="sapling-setup"></a>

### Setting up Keka HR Integration <a href="#locating-and-generating-new-api-keys" id="locating-and-generating-new-api-keys"></a>

1. Go to Drivetrain's data page and Click on **+** button on top left corner

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

2. Select the Keka HR connector from the list of integrations and enter the **Subdomain** of your account and click **Next**

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

3. Enter Client ID, Client Secret and API key generated from previous steps and click **Next**

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

4. After a successful authentication, you will be directed back to Drivetrain's **Connected Integrations** page. Once the data sync is completed, you will be able to see the Keka HR Datasets.


---

# 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://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/hris-and-ats/integrating-with-keka-hr.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.