Skip to main content
The Darwinbox connector indexes HR directory and organization data from Darwinbox and exposes HR workflow actions for the AI assistant and background agents.

​
Overview

​
What Gets Indexed

​
How It Works

  1. You provide your Darwinbox base URL, tenant credentials, and dataset key
  2. The connector syncs enabled modules and stores a checkpoint for resumable syncs
  3. Synced employee and org data becomes searchable in Omni
  4. Optional action modules expose self-service, manager, HR operations, ATS, and report actions to agents
Darwinbox tenant capabilities and API availability vary by deployment. Enable only the sync and action modules your tenant supports.

​
Prerequisites

Before setting up the Darwinbox connector, ensure you have:
  • Darwinbox API access for your tenant
  • Base URL for your Darwinbox instance, such as https://acme.darwinbox.in
  • Dataset key for the APIs Omni should call
  • One supported credential set:
    • Basic auth username, password, and API key
    • OAuth2 client credentials
    • Legacy dynamic-token credentials with an authorization code or refresh token
  • Omni deployment with the Darwinbox connector service running (profile: darwinbox)

​
Setup

​
Step 1: Connect in Omni

  1. Navigate to Settings → Integrations
  2. Find Darwinbox and click Connect
  3. Enter your Darwinbox base URL
  4. Choose an authentication mode:
    • Basic auth + API key: API username, password, API key, and dataset key
    • OAuth2 client credentials: Client ID, client secret, optional API key, and dataset key
    • Legacy dynamic token: Client ID, client secret, grant type, authorization code or refresh token, optional API key, and dataset key
  5. Set the Default timezone if needed
  6. Choose optional modules:
    • Sync position master
    • Enable ATS jobs/actions
    • Enable HR lifecycle actions
    • Enable report actions
  7. Click Connect
  8. Click Sync to start the initial sync
Your Darwinbox connector is now configured. Initial indexing time depends on the number of employees and enabled modules.

​
Managing the Integration

​
Viewing Sync Status

Navigate to Settings → Integrations to view sync status, indexed counts, and errors. Click Settings on the source for sync history and source configuration.

​
Sync Modes

​
Search Operators

The connector registers source-specific operators that work in Search and Chat once the source is running:

​
AI Assistant Actions

Darwinbox actions are grouped by module: Write-capable actions are only registered when the corresponding action module is enabled and are subject to the same agent/chat approval and action-allowlist controls as other connector actions.

​
Removing the Integration

  1. Navigate to Settings → Integrations
  2. Click Settings against the Darwinbox source
  3. Click Delete Permanently
  4. Revoke or rotate the Darwinbox API credentials if needed

​
Troubleshooting

Verify the base URL, authentication mode, credentials, API key, and dataset key. Remove any trailing slash from the base URL.
Confirm your Darwinbox tenant has the relevant API enabled. Disable optional modules such as positions or ATS if your tenant does not expose those endpoints.
Check that the source is enabled, the action module is enabled, and the current chat or background agent is allowed to use the Darwinbox source/action.
The connector can use Darwinbox permission data and optional admin/recruiter email lists in source configuration. Review the source settings and verify the synced employee directory contains the expected email addresses.

​
Security Considerations

  • Credential storage: Darwinbox credentials are encrypted at rest in Omni
  • Module scoping: Keep optional HR, ATS, and report actions disabled unless your team needs them
  • Write actions: HR lifecycle, leave approval, ATS, and document-upload actions can change data in Darwinbox; expose them only to trusted agents or users
  • Token rotation: Rotate API keys, passwords, client secrets, and refresh tokens according to your Darwinbox security policy

​
What’s Next

Search Your Data

Learn how to search HR and organization data

Background Agents

Use approved HR workflow actions in agents

Connector Management

Monitor syncs and manage the source