Enabling and using the Joinedly integration

Available for User roles Super Admin, Admin, Team Member, Limited Team Member
Can only be configured by Super Admins
Packages All packages

The Joinedly integration will automatically add hired candidates to Joinedly to begin their journey. Relevant fields on Lever will be mapped to Joinedly fields automatically.

Readers of this article will learn the following:

Setup the integration:


Access role must be Super Admin in Lever to set up the integration. You must be a team or organization with admin rights in Joinedly to install this integration.

Estimated Time: 2-5 minutes

Integration steps are to be completed once. Please follow the steps clearly. You may reach out to founders@joinedly.com if you face any issues.

Step 1. On Joinedly, go to Integrations, select Lever Integration & Sign In. 

  • You will see two options:
    • Sign in with Lever
    • Signature Token (generated on Lever)
  • Click Sign in.

Joinedly dashboard with lever sign in modal and sign in button outlined

  • On the next screen, log into your Lever account.

Lever login page

  • Review list of requested permissions. Click Accept to authorize app. 

Lever and Joinedly authorize app modal showing list of permissions and blue accept button

Step 2: On Lever, Turn On the Webhook

  • Click here or go to Settings > Integrations and API > Webhooks on Lever.
  • Turn on the "Candidate Hired" webhook by toggling the toggle to the on (green) position. 

Lever settings integrations and API page with candidate hired webhook outlined

The signature token will automatically be added to Joinedly. 

That's it, you are done setting up the integration. You can now test the Lever integration. 

How to configure the integration:


The following steps must be completed for consistency. 
  • Please make sure that Locations & Teams are “exactly the same” on Joinedly. Locations are called Offices on Joinedly. Update, as needed to maintain consistency between Lever and Joinedly. 

On Lever

  • Go to Settings > Company > Locations to access Locations. 

Lever company settings with locations section outlined

  • Go to Settings > Company > Departments & Teams to access Teams

Lever company settings with teams section outlined

On Joinedly

  • Go to Offices under Settings > General

Joinedly settings with offices field outlined

  • Go to Teams under Settings.

Joinedly settings with configure teams page with list of job postings

How to use the integration:

Whenever a candidate is marked as “Hired” on Lever, they will automatically get added on Joinedly and their journey will start. Relevant fields of Lever will be mapped to Joinedly fields automatically.

Additional Information:


In case of a security breach. If you feel that there is any security breach of data between Joinedly & Lever, you must regenerate a security token and update it on Joinedly.

Lever integrations and API settings candidate hired section with generate token outlined

Joinedly lever signin modal with signature token and field outlined

How to disable the integration:

1. Navigate to your Integrations & API Settings Page in Lever.

2. Under the Authorized Apps tab, locate the Joinedly app.

3. Click Revoke Access to disable the integration.

Was this article helpful?
1 out of 1 found this helpful