---
description: Integrating Darwinbox with Empuls for automated user data management
---

# Darwinbox

## **Why This Integration?**

This integration automates the user account management processes in Empuls based on the employee data available in Darwinbox, letting you appreciate and recognize your team members directly and instantly through your already existing Darwinbox framework.

With this integration, you can :

* Add new employees to Empuls automatically as soon as their Darwinbox profile is created.
* Edit existing employee data in Empuls simply by updating their Darwinbox profile.
* Remove exited employees from Empuls based on their exit date in Darwinbox.&#x20;

Once this integration is enabled, the data will sync between Empuls and your Darwinbox account once every 24 hours.

This article will show you how to set up your Darwinbox integration and go on a strategic recognition spree.

## **How To Set This Integration Up** <a href="#kg69u86enauf" id="kg69u86enauf"></a>

Contact your Darwinbox account manager and request him to share the below client details concerning your Darwinbox account.

### **Step 1: Provide your Darwinbox credentials:**

Here the admin is required to provide the darwin box credentials to connect with the Darwinbox API's to fetch all employee data. Contact your Darwinbox account manager to get the below client details concerning your Darwinbox account.

* Email: Email registered with Darwinbox
* Domain: HRMS domain name
* User ID: UID (Unique Identifier)
* Secret Key
* Dataset Key\[Active]
* Dataset Key\[Inactive]

We need both Active and Inactive Dataset keys.

<figure><img src="https://1067480511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MOm3lvi2GZUOthqehhF%2Fuploads%2FbE0lraUyANGgYJtLeHyW%2FScreenshot%202022-09-27%20at%202.13.20%20PM.png?alt=media&#x26;token=39c4b4de-fe44-4af1-8d09-d2b35e270063" alt=""><figcaption></figcaption></figure>

This step concludes one your Darwinbox credentials are validated. You will be redirect to next step towards this integration.

### **Step 2: Map Data Fields** <a href="#q1s8biu6mwn5" id="q1s8biu6mwn5"></a>

This step allows you to select and map the data fields to be uploaded to your Empuls account. You can do the following in step 2.

* Select the data fields to be imported to Empuls. All the fields are selected by default, You may uncheck the boxes to unselect specific fields. For example, Uncheck the Work Contact Number fields if you do not wish to share this information with Empuls. A few fields like the First Name, Email id, and Status are mandatory and thus cannot be unchecked.&#x20;
* Map the data fields on your Darwinbox account to the right fields on Empuls to configure the platform in line with your needs
* Select date format for Date of Joining & Date of birth fields to ensure that dates are updated correctly on Empuls

<figure><img src="https://1067480511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MOm3lvi2GZUOthqehhF%2Fuploads%2Fv2GgKpt87LMJBqKvdfS8%2FDarwinbox.png?alt=media&#x26;token=01d4283c-310d-4f56-84b1-1bad38670f63" alt=""><figcaption></figcaption></figure>

### Step 3: Define Filtering Criteria

Here you may add your filtering criteria to avoid account creation for external consultants, and test accounts that you may have created on your Darwinbox account. You can choose to skip this step if not relevant to your organization.

![](https://1067480511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MOm3lvi2GZUOthqehhF%2Fuploads%2F8MoRQs05AkUn0YoYahMP%2F36.png?alt=media\&token=d9bcc55a-9ab5-49f2-a287-8a5fa9455769)

### Step 4: Schedule Data Sync

Here you may choose between two data sync options:

![](https://1067480511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MOm3lvi2GZUOthqehhF%2Fuploads%2F81Bj2pQBIYIo8P4gME8d%2FSchedule%20DS.png?alt=media\&token=395af09a-2a55-4dac-bfef-0cbadc1a1e46)

* Run Date Sync Once Now: Select this option to launch your Empuls immediately. This will create accounts for all employees and send invites.
* Schedule First Data Sync for Later: Select this option to schedule employee account creation to a later date and time. This will help you plan and execute employee account creation on Empuls to coincide with your internal launch announcements.

Click on Save & Finish to complete your integration setup.
