Overview

Integrating OneLogin with imper.ai allows the platform to securely set a new hire's corporate password through your existing OneLogin account.

Once connected, imper.ai sets the new hire's password as part of the enrollment flow - delivering their corporate credentials once their identity is verified, before their first day, without a manual HR-to-IT handoff.

This article walks you through the required prerequisites and the steps for preparing the OneLogin API credentials, configuring permissions, and completing the integration inside imper.ai.

Prerequisites

To integrate OneLogin with imper.ai, you must have OneLogin Account Owner or Administrator permissions (or equivalent privileges to create API credentials) via the OneLogin Admin Console.

Deployment Steps

Step 1: Create OneLogin API credentials

1. Using a OneLogin admin user, login to your OneLogin Admin Console (https://<your-subdomain>.onelogin.com).

2. In the top navigation bar, open the Developers menu and click API Credentials.
   

3. On the API Access page, click New Credential (top-right).
   

4. In the Create new API credential dialog:

   1. Enter a recognizable Name for the credential (for example, imper-api-key).

   2. Select the Manage users scope — this grants read/write access to user fields, roles, and groups, which is required for imper.ai to set the new hire's password.

   3. Click Save.
      

5. The credential is created and its Client ID and Client Secret are displayed:

   1. Click the copy icon next to Client ID - this ID needs to be entered later in imper.ai’s integration interface.

   2. Click the copy icon next to Client Secret - this secret needs to be entered later in imper.ai’s integration interface.
      

6. Click Done to close the dialog.

WARNING

The Client Secret is sensitive and is only fully accessible at creation time. Store it securely and do not share it. If it is lost, create a new credential.

Step 2: Connect OneLogin to imper.ai

1. Login to the imper.ai admin integrations page.

2. Locate OneLogin and click Connect.

3. In the integration dialog, fill in your OneLogin subdomain (or organization URL) and the Client ID and Client Secret obtained in the previous step.

4. Click Connect , and a connection attempt will be made to verify the credentials and privileges.