Register OAuth Application with Lever
To connect Lever with StackOne, you need to register your application through Lever’s Partner Program. This process involves becoming a partner, registering for OAuth, and receiving credentials from the Lever team.
Become a Lever Partner
Start by expressing interest in building a product integration with Lever through their Partner Program.
- Navigate to the Lever Partner page and submit an application to become a partner.
- Once approved, the Lever team will provide you with a Lever sandbox account for development.
- You’ll receive login credentials for your sandbox environment.
Access OAuth Registration Form
After receiving your sandbox account, you’ll need to register your OAuth application to receive Client ID and Client Secret credentials.
- Navigate to the OAuth Registration Form provided in the Lever OAuth documentation.
- Review the OAuth requirements and documentation before proceeding with registration.
Complete Registration Form
Fill out the OAuth application registration form with the required information about your integration.
- Integration Name - Enter your company name or the name of the product being connected to Lever.
- Integration Description - Provide a description between 20 and 140 characters. This will be displayed in the Lever integration ecosystem.
- Callback URL: copy it from your Connector Profile as the redirect URI.
- Square Logo URL - Provide a direct link to your square logo (150x150px recommended).
- Required Scopes - Select the OAuth scopes your integration needs (typically 5-8 scopes, maximum 20). Write scopes include all corresponding read permissions.
Submit and wait for credentials
Click Submit. The Lever team reviews your application and creates your OAuth app.
- Lever sends you the Client ID and Client Secret. Copy them into your Connector Profile.
- After development and QA review, you receive production credentials for
https://api.lever.co/v1/.
Understanding Environments
Lever provides separate sandbox and production environments for development and live operations.
Sandbox Environment
The sandbox environment is used for development and testing without affecting live data.
- Base URL -
https://api.sandbox.lever.co/v1 - Use Case - Development, testing, and QA validation
Production Environment
The production environment is used for live integrations with real candidate data.
- Base URL -
https://api.lever.co/v1 - Use Case - Live production integrations
Understanding OAuth Scopes
Lever OAuth scopes control what data and operations your application can access.
Scope Structure
Lever scopes are organized by resource type and access level.
- Read scopes - Allow viewing data (e.g., opportunities:read:admin)
- Write scopes - Allow viewing and managing data, includes corresponding read permissions (e.g., opportunities:write:admin includes opportunities:read:admin)
- offline_access - Required scope to receive a refresh token for maintaining persistent authentication
Default Scopes
If no custom scopes are specified during StackOne configuration, the integration will use a comprehensive set of default scopes.
Required Scopes for Custom Configuration
Note: Both offline_access and users:read:admin scopes must be included when configuring custom scopes.
Create the StackOne Connector Profile
Create a Connector Profile
Link an Account