Lever¶
Lever is a popular applicant tracking system (ATS) and recruiting software used by companies to manage their hiring processes.
Lever Connection Setup¶
Hire2Retire leverages OAuth 2.0 authentication to establish a secure connection with Lever. To enable this integration, you must have an active Lever account and an OAuth Application configured.
Create OAuth Application¶
To establish an OAuth connection, you need to register your application in Lever. Follow these steps to set up your OAuth application:
- Integration name - Your company name, or the name of the product being connected to Lever.
- Description of your app - The description must be between 20 and 140 characters.
- Callback URL(s) - Add the following callback URL to your application:
https://hire2retire.robomq.io/api/auth/callback/LeverATS
. - Link to your Logo - Provide a URL to your application's logo. This image will be displayed in the Lever interface.
- Required Scopes - Assign the following scopes to your application:
opportunities:read:admin
,postings:read:admin
,confidential:access:admin
,offline_access
.
For additional details, refer to Lever’s official guide on creating an OAuth application.
Create A Lever Connection on Hire2Retire¶
- Connection Name - A user-defined nomenclature for your connection. By default, the connection name is "Connection-OAuth-1", you can change the name as per your preferences.
- Client ID - You will get your client ID after configuring the application in Lever. Alternatively, you can navigate to
Settings
>Integrations and API
>OAuth
. - Client Secret - You will get your client secret after configuring the application in Lever.
- Environment - The specific type of Lever account, such as Production or Sandbox.
Steps For Creating A Connection :
-
Go to the Connections page on Hire2Retire and fill in the connection details for Lever. Click the
Link Account
button.Figure 1. Lever connection page in Hire2Retire -
You will be redirected to log in to Lever.
Figure 2. Lever log in -
Now grant the required permissions by clicking on Accept.
Figure 3. Lever consent form -
You will be redirected to Hire2Retire's
Connections
page. Your connection is successfully set up.Figure 4. Lever Connection Successful in Hire2Retire
Configuration¶
Once you have successfully configured the connections, you can continue with the Design section to configure the rest of the workflow following these steps in order.
- ATS Data Definition
- ATS to AD Profile Map
- Lifecycle Business Rules
- Employment Status
- Organizational Unit Assignment - Only defined in on-premise Active Directory
- Group Memberships
- Security Group Memberships
- Distribution List Memberships
- Microsoft 365 Groups Memberships - Only defined in Hybrid (with Exchange Online Services) and Entra ID
- Entra ID Distribution List Memberships - Only defined in Entra ID and Hybrid, when Exchange Online Services is configured
- Entra ID Security Groups - Only defined in Hybrid (with Enable Entra ID Security Groups) and Entra ID
- Mail Enabled Security Group Memberships - Only defined in Entra ID and Hybrid, when Exchange Online Services is configured
- Mailing List Assignment - Provided in Google Workspace
- Communication Hub
Deployment¶
Once your workflow has been setup, you can optionally setup notifications and archival for your workflow.
- Compliance and Audit Trail
- Run Mode
- Error Notifications
- Monitor Receipt of Scheduled HR Extract
- Environment
Otherwise, you can proceed to deploy and test it on the Hire2Retire platform, see Deploy and Test Flow.