> For the complete documentation index, see [llms.txt](https://integrations.drivetrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/hris-and-ats/integrating-with-keka-hr.md).

# 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
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, and the optional `goal` query parameter:

```
GET https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/hris-and-ats/integrating-with-keka-hr.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.