> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refold.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect

> Connect with the Linked Account's Keka account.

<Note>
  Keka is a **Key** based integration and does not require the setup of an app.
</Note>

### Required Credentials of a Linked Account

To successfully connect with the **Keka HR** integration, a Linked Account or an end-user will need to provide the following to connect:

1. Client ID
2. Client Secret
3. API Token
4. API Domain

<Info>
  To understand how a Linked Account can get the above mentioned credentials, refer below.
</Info>

### Getting Credentials of Keka

To acquire the required credentials and connect a Linked Account, please follow the steps mentioned below:

<img height="200" src="https://mintcdn.com/cobalt-55/rCTCKBbhiwGPdeWb/images/keka/keka_config.png?fit=max&auto=format&n=rCTCKBbhiwGPdeWb&q=85&s=697e6a9493df8a095bfdef1769a26631" alt="Connect a Linked Account" data-path="images/keka/keka_config.png" />

1. Log in to your Keka account and copy the Domain of your Keka account. This is the `API Domain`.
2. Click on the `Gear` icon in the top nav bar and select `Integration and Automation` button.

<img height="200" src="https://mintcdn.com/cobalt-55/rCTCKBbhiwGPdeWb/images/keka/keka_navigation.png?fit=max&auto=format&n=rCTCKBbhiwGPdeWb&q=85&s=186db3b4b44d4d0bcba89508cbb9ec31" alt="Navigation for API Key" data-path="images/keka/keka_navigation.png" />

3. Go to `API Access` tab  and click on `Create New Key` button.
4. Enter the `Name` > Copy the **API Key** (API Token) > Select the **scopes** required and click on `Save`.
5. Copy the **Client ID** and **Client Secret** from the API Key section.

<img height="200" src="https://mintcdn.com/cobalt-55/rCTCKBbhiwGPdeWb/images/keka/keka_credentials.png?fit=max&auto=format&n=rCTCKBbhiwGPdeWb&q=85&s=26291010f500637d927c2c42158c2dcd" alt="Getting Credentials" data-path="images/keka/keka_credentials.png" />

#### Keka Single Webhook URL

If you wish to create an orchestration where a workflow is being triggered when some operation occurs in Keka HR, you'd need to subscribe to Keka's Webhook. Refold provides
a single webhook URL to manage such event triggers for all your customers.

**To setup Keka webhook subscription:**

1. Select **Keka** from the application list in **Refold**, and select `Settings`.

2. Copy the `Single Webhook Url`

3. Go to `Communications` in your Keka Account Settings.

4. Select the Event Category which you want to subscribe to > Select the `Event` > Click on `Add Action` > `Webhook` > Give the Webhook a `Name` > Paste the `Single Webhook Url` inside the "Webhook Endpoint" field.

5. Click on `Test` and click on `Create`.

<img height="200" src="https://mintcdn.com/cobalt-55/rCTCKBbhiwGPdeWb/images/keka/keka_webhook.png?fit=max&auto=format&n=rCTCKBbhiwGPdeWb&q=85&s=cd46f51ebcf8abce546c2a7053da212e" alt="Setting up Keka Webhook URL" data-path="images/keka/keka_webhook.png" />

#### Actions and triggers

Once the above setup is completed, you can create orchestrations of your use-cases using Keka actions and triggers. Following are the set of Keka actions and triggers
supported by Refold.

<Tabs>
  <Tab title="Actions">
    <AccordionGroup>
      <Accordion title="Candidates">
        1. **Get Candidates** - Get all candidates in Keka.
        2. **Create Candidate** - Create a new candidate in Keka.
        3. **Update Candidate** - Update a candidate in Keka.
      </Accordion>

      <Accordion title="Employees">
        4. **Get All Employees** - Get all employees in Keka.
        5. **Create Employee** - Create an employee in Keka.
        6. **Get Employee** - Get an employee in Keka.
        7. **Update Employee** - Update an employee in Keka.
      </Accordion>

      <Accordion title="Jobs">
        8. **Get Jobs** - Get all jobs in Keka.
      </Accordion>

      <Accordion title="Projects">
        9. **Get Projects** - Get all projects in Keka.
        10. **Create Project** - Create a new project in Keka.
      </Accordion>

      <Accordion title="Time Entries">
        11. **Get Time Entries** - Get all time entries in Keka.
      </Accordion>

      <Accordion title="Others">
        12. **HTTP Request** - Make HTTP API calls to any Keka documented REST APIs.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Triggers">
    1. **Employee Added** - Triggers when an employee is added on Keka.
  </Tab>
</Tabs>