---
updatedAt: 2026-07-02T13:07:02.000Z
agentTools:
  projectIndex: https://developers.keka.com/llms.txt
---

# eSign / Digital Signature Partners guide

As a Digital Signature / eSign / Document signing partner working with Keka you can follow these steps to enable your customers to Initiate document signing  through Keka with approval workflows and upload the signed documents back to Keka

# Step 1: Create a new eSignature App

* Create a **"New App"** using the [**Keka App portal**](https://appbuilder.keka.com)

* Select the "eSignature App" template to configure the permissions automatically.

  <Image src="https://files.readme.io/7926a4a6febaefff07d9656f87260710345e551f020ceb174fd11fe4e999bebf-image.png" align="center" border={true} />

* Configure your app by adding the required info in the App URL tab

  * Redirect URL (for Production and Development)
  * Company Name
  * Short Description

* Check the Permissions and Event Subscription tabs

* Add a **Request URL** on the "Event Subscription" page, you will receive a Webhook in the following format:
  ```text
  {
    "requestIdentifier": "{{RequestIdentifier}}",
    "employeeNumber": "{{EmployeeNumber}}",
    "employeeName": "{{EmployeeName}}",
    "employeeIdentifier": "{{EmployeeIdentifier}}",
    "jobTitle": "{{JobTitle}}",
    "assigneeEmployeeNumber": "{{AssigneeEmployeeNumber}}",
    "assigneeName": "{{AssigneeName}}",
    "assigneeIdentifier": "{{AssigneeIdentifier}}",
    "assigneeEmail": "{{AssigneeEmail}}",
    "assigneeJobTitle": "{{AssigneeJobTitle}}",
    "vendorId": "{{VendorId}}",
    "vendorName": "{{VendorName}}",
    "templateName": "{{TemplateName}}",
    "generatedOn": "{{GeneratedOn}}",
    "subDomain": "{{SubDomain}}",
    "eventType": "{{EventType}}"
  }

  ```

*

<Callout icon="💡" theme="default">
  ### This Event subscription can acts as a "trigger" for fetching pending Digital Signature requests for your app
</Callout>

*

# Step 2: Add "Document Management" Category to your app

<Callout icon="🚧" theme="warn">
  ### Without adding the "Background" category your app will not be visible in the Sandbox for testing as an Background Verification Provider
</Callout>

* Click on the **Listing Details** tab -> Add "Document Management" as the app category for your app

  <Image src="https://files.readme.io/99c7079348e61c899a0ce0286379b059bdefbb2fd62e30f7b2a9fef1f807c402-image.png" align="center" border={true} />

# Step 3:  Install your app in the Keka Sandbox

* Now click on the **Testing and Installation** tab, click on the "Install App" button in the Keka App portal

  <Image src="https://files.readme.io/4709adbd19ae053caefb059c5a49caa2f0f1119302fefc97b737b7da0673dec6-image.png" align="center" border={true} />

  <Image src="https://files.readme.io/822820e43d41f251d7c5d39afb8b61a3cbba66c68df0742053a3b2a356a2df46-image.png" align="center" border={true} />

* Open your Keka Sandbox and search for your eSignature app

* Click on Install button on the app listing page and Install your app in the Sandbox.

  ![](https://files.readme.io/c2569f3f50fe5a6b09d54ad282c37effc467f1d934dab2c5c33fea981ffcad8d-image.png)

* An OAuth code will be shared with the **Redirect URL** added by you in Step 1 earlier

* Refer to [**Step no. 8 on the App builder documentation**](https://developers.keka.com/page/how-to-create-your-first-app-or-service-on-keka-app-portal#step-8-use-oauth-for-authentication) and create an access token using this OAuth token which will be further used as a "Bearer token" to access Keka APIs

# Step 4: Find your "appId"

* You can find and copy your appId from the app URL in the App portal or your Sandbox

![](https://files.readme.io/30fdffd5b6e85055cc8941c260cb4b2eae90793a7b5258cfbabd36dbd3267e71-image.png)

<Callout icon="📘" theme="info">
  ### Your appId is used as the "vendorId" while accessing the Keka Background Verification API in the next steps
</Callout>

# Step 5: Initiate a background verification request for a Candidate or Employee from the Keka Interface

* Follow [this documentation](https://help.keka.com/admin/enabling-docusign) to initiate a create a letter for signing in Keka
* Note: Select your testing app as the signing platform instead of DocuSign

# Step 6: View available documents for signing

* Use the [**Get Digital signature workflow request details**](https://developers.keka.com/reference/get_hris-e-sign-vendorid-letterrequests) to check the Document signing requests Initiated from Keka
* You will receive the following fields in the list of initiated document signing requests:
  * `id`: corresponds to the unique "requestId" for this signing request
  * `documentName`: name of the document available for signing
  * `employeeId, assigneeId`: ID of the employee and assigner, you can use the [Get employee API](https://developers.keka.com/reference/get_hris-employees-id) to fetch the details associated with an employee and the assigner
  * `signatureCoordinates: Coordinates where the signature is supposed to be done including page number and the x and y coordinate`
  * You can download the actual document using the [**Get Digital signature workflow document**](https://developers.keka.com/reference/get_hris-e-sign-vendorid-letterrequests-letterrequestid-attachments) API
  * Partners can use these details and the document to initiate the Signing process for a particular user through their platform.
* Once the Signed document for an employee is ready you can upload it to Keka using the [**Upload digitally signed document**](https://developers.keka.com/reference/put_hris-e-sign-vendorid-letterrequests-letterrequestid) API and wait for other steps to be completed on Keka in the meantime and download the document again using the GET digital signature requests API once the document is ready to be signed after approval. You can run a scheduled cron job for fetching the pending documents once approval flow or actions are completed in Keka

<br />