# Humaans Integration

The following guide helps you integrate and configure Humaans with Sprinto for people and user access management. Based on your use case, you can follow the applicable procedure.<br>

### How does this integration help <a href="#how-does-this-integration-help" id="how-does-this-integration-help"></a>

The integration helps sprinto in the following ways:

* People management: The integration simplifies the retrieval of essential staff details, including names, email addresses, job roles, onboarding dates, and reporting managers from Humaans. This ensures Sprinto maintains current staff information and meets compliance requirements efficiently.
* User access monitoring: The integration enhances user access control by validating user accounts from Humaans against defined access criteria. Sprinto identifies and flags any unauthorized or invalid access, triggering checks to revoke inappropriate permissions and maintain system security.

#### Sprinto checks for Humaans <a href="#sprinto-checks-for-humaans" id="sprinto-checks-for-humaans"></a>

Below are the Sprinto checks for the following integration types:&#x20;

* People management: Sprinto checks for people management

| Sprinto check                                    | Check description                                                                                                                                 | Reference procedure                                                                                                                      |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Staff role should be assigned                    | All in-scope staff members must have an assigned staff role.                                                                                      | <p><br><a href="../../data-library/people/dashboard-actions/manage-staff-and-organisational-configuration">How to fix</a></p>            |
| Reporting manager should be assigned             | <p>All in-scope staff members should have an assigned reporting manager.</p><p>Note: Top management roles like CEO, CTO, etc. are exceptions.</p> | <p><br><a href="../../data-library/people/dashboard-actions/manage-staff-and-organisational-configuration">How to fix</a></p>            |
| Date of joining for new staff should be provided | Define the joining date for all newly onboarded staff members.                                                                                    | <p><br><a href="../../data-library/people/dashboard-actions/manage-staff-and-organisational-configuration">How to fix</a></p><p><br></p> |

* Users' access monitoring: Sprinto checks for users' access monitoring

| Sprinto check                                            | Reference procedure                                                                                                                                                                                                        |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Humaans access should be removed for offboarded user** | [How to fix](https://docs.sprinto.com/monitors/authentication-and-access-monitors/resolve-sprinto-check-for-removing-access-for-offboarded-users)                                                                          |
| **User should be identified**                            | [How to fix](https://docs.sprinto.com/data-library/access/dashboard-actions/view-and-map-staff-access)                                                                                                                     |
| **User access to critical system should be valid**       | <p><a href="../../data-library/access/dashboard-actions/view-and-map-staff-access">How to fix</a> </p><p>Note: The user access to the critical system becomes valid if the respective Org role is added to the system.</p> |

### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

* Log in on Sprinto as administrator.
* Ensure you have administrator access on the Humaans account to grant necessary permissions to Sprinto.

Integrate Sprinto with Humaans

Follow the below applicable procedure:

#### People Management <a href="#people-management" id="people-management"></a>

Note: [Merge](https://merge.dev/) is our integration partner for Humaans for employee management. Sprinto utilizes Merge’s API capabilities to streamline data inflow from the Humaans account.&#x20;

1. Get the API key from your Humaans account.
   * Log in to[ Humaans account](https://app.humaans.io/) using your credentials.
   * Click on the three dots option next to the profile icon, then click API access tokens.\
     &#x20;

     <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318755/original/fX2ZStKULXSVqwdUHNt5kemf1RirpXulIQ.png?1722690306" alt=""><figcaption></figcaption></figure>
   * Click Generate New token.
   * Enter a name for the token, and select the following permissions:
     * View public and private data
   * Click the Create access key.|<br>

     <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318774/original/gYLnFRSF8rz98CZ-KLh9hCxpvv0Mb91rfQ.png?1722690313" alt="" width="375"><figcaption></figcaption></figure>
2. Integrate Humaans with Sprinto.
   * Go to  Settings > Integrations > Available, and click Connect next to Humaans.

     <figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2Fq5dAlReLEBHgSrRsmAtd%2FScreenshot%202025-09-25%20at%2012.03.22.png?alt=media&#x26;token=89c560a0-bf5f-4bfa-b04c-88c9ad89f9d4" alt="" width="563"><figcaption></figcaption></figure>
   * Click Connect next to Humaans for Employee Management.
   * Read the on-screen instructions and click Next.<br>

     <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318766/original/OUdHiedTZ60ejoBn_epMJgbUto1qQm7e4g.png?1722690311" alt="" width="375"><figcaption></figcaption></figure>
   * Select the acknowledgment checkbox, and click Connect to Humaans. \
     Note: Ensure you have enabled the pop-up window on your browser.<br>

     <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318761/original/SrbobA-T82Rvz_jrrhKxmYbzxugA9QfVzA.png?1722690307" alt="" width="375"><figcaption></figcaption></figure>
   * From Humaans integration page, Click I am an admin, then click Next.<br>

     <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318771/original/hhtWkevFEdBHNCkocqQiCB21PZAMwXX7GA.png?1722690313" alt=""><figcaption></figcaption></figure>

* Enter the API key you have copied from Step 1, and click Next.<br>

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318764/original/ZnB1mPmO7DREcbHOApiSVrvDcKZV1gjS-Q.png?1722690309" alt=""><figcaption></figcaption></figure>

3. Configure Humaans as a staff information provider.

* From the Sprinto admin portal, navigate to Data Library > People > Configuration, and click Add or Manage.
* On the Staff information provider page, click Add Staff.<br>

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318754/original/ODetgPoSj5HoFMo6Dt_5EjqRbtXoa3FoIw.png?1722690305" alt=""><figcaption></figcaption></figure>
* On the Add staff member page, select Add staff from HRMS, then click the details button next to Humaans.<br>

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318769/original/u8-s78ogztRVa0qVfV7cZ402GCGllNRSFw.png?1722690313" alt=""><figcaption></figcaption></figure>
* On Add Humaans as a Provider page, click Add Humaans.\
  Note: Connected is highlighted if integration is built successfully in the previous step.

#### Access Management <a href="#access-management" id="access-management"></a>

Note: [Truto](https://www.truto.one/) is our integration partner for Humaans for user access monitoring. Sprinto utilized Truto’s API capabilities to streamline data inflow.&#x20;

1. Get the API key from the Humaans account.

* Refer to Step 1 about Getting the API key from the people management section of this guide.

2. Integrating Humaans with Sprinto.

* From Sprinto admin portal, navigate to **Settings** > **Integration**, then select the Available tab.&#x20;
* Click Connect next to Humaans.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2FS3Yw1MkyZNWVI2bfUqrH%2FScreenshot%202025-09-25%20at%2012.04.35.png?alt=media&#x26;token=1795fb10-31a9-4ef7-b31d-32d94fed8da2" alt="" width="563"><figcaption></figcaption></figure>

* Click Connect next to Humaans for Access Review.
* Read the on-screen instructions, then click Next.<br>

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318770/original/rRCCqwJ7n0nlQfzwLUrZQoufIPS0sSfIyg.png?1722690313" alt="" width="375"><figcaption></figcaption></figure>
* Select the acknowledgment checkbox, then click Connect to Humaans.\
  Note: Ensure you have the pop-up window enabled on your browser.<br>

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318775/original/ffdjzJ5nZYKxP0AgPGnEl2TJOhe_7OFeyw.png?1722690313" alt="" width="375"><figcaption></figcaption></figure>
* Enter the API key from Step 1, then click Connect.<br>

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318753/original/217716cKa4ucW5-EJZ_ThdEQF-Mk1Cydiw.png?1722690305" alt=""><figcaption></figcaption></figure>

3. Configure Humaans for access monitoring.

* From the Sprinto admin portal, navigate to Data Library > Access, then select the Overview tab and click + Add Critical System.
* Select Humaans from the critical system library, then click Add Systems. “Connected” is highlighted next to Humaans if integration was built successfully in the previous step.
* On the [Access Overview](https://app.sprinto.com/app/admin/accessControl/overview) page, select Humaans from the critical systems list.<br>

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318773/original/6HdfNhSYxTJjaupCPy47tR-uoG5J04OcPg.png?1722690313" alt="" width="563"><figcaption></figcaption></figure>
* Click Configure or Manage from the Summary tab.<br>

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318779/original/-0MShd633NTqfinNOuHk_cMVi2E25hdKaw.png?1722690313" alt="" width="563"><figcaption></figcaption></figure>
* Click Configure or Edit next to Access monitoring.<br>

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318758/original/hhbP-LsahOaqGSYDgi8aVsHHMqjifNdBGA.png?1722690307" alt=""><figcaption></figcaption></figure>
* Define the valid user access type for Humaans.

  <figure><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72109318768/original/JRozRPWG2O_GLoSwwWfrqVGxlze7LkJitQ.png?1722690313" alt=""><figcaption></figcaption></figure>

Please contact [Sprinto Support](mailto:www.support@sprinto.com) if you have any queries related to the integration or need assistance.
