Appearance

Lever ​

This article will take you through the steps to setup a Lever integration and connect your first Lever account.

There are two ways of setting up a Lever integration in Truto.

  1. [RECOMMENDED] Setup an OAuth application in Lever and use it in Truto. Please mention that you are going to use Truto as your integration provider in the partnership interest form.

  2. Use API Key based integration, where the end customer keys-in their API Key. Ideal for PoCs and supporting one or two customers.

Going with the OAuth application approach has added benefits

  1. Customers can enable your integration in one-click.
  2. No sensitive data transfer; no manual steps; and much less chance of error.
  3. Official partnership opportunities are available to integrators who have built OAuth-based integrations to Lever.
  1. Create an OAuth application in Lever and note down the client_id and client_secret for your OAuth application. The redirect URL you have to use is https://api.truto.one/connect/lever/callback.
  2. Open up the Lever integration in Truto.
  3. Click on the Clone button in the integration details page. Lever integration page in Truto
  4. Scroll down to the Authentication section and change it to OAuth 2.0Select OAuth 2.0 in the authentication section
  5. Key in the following details
    i. Client ID
    ii. Client Secret
    iii. Authorization Hoste (only the host part, e.g. https://api.lever.com)
    iv. Token Host (only the host part, e.g. https://api.lever.com)
    v. Scopes
    vi. Authorization Path
    vii. Token Path
    viii. Audience (via the Add authorize URL params button)
    Enter the OAuth credentials for Lever
  6. Scroll down to the Authorization section and select Bearer Auth in the Format dropdown and enter the following in the Bearer token field - {{oauth.token.access_token}}.Select Bearer Auth as the authorization format
  7. Scroll to the top of the page and click Save and then Install to install the integration. Save the integration and install it

API Key based integration ​

Ignore this if you have already setup an integration using the recommended OAuth based flow.

This integration flow is recommended for PoCs and supporting one or two customers. You just have to install the Lever integration and proceed with the steps to connect Lever accounts below.

Connecting a Lever account ​

  1. Click on Connect AccountClick connect account

  2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on Get connection linkGet connection link

  3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their Lever account. Share connection link

  4. Select Lever Select Lever

  5. You'll now be asked to log in to your Lever account and allow access to Truto. Go through the steps.

  6. Voila! You should now see a connection successful message. You can now close this tab.

  7. Go to your Truto account, and you should see the new Lever integration under Integrated Accounts. Click on the Account ID to view the details and initiate API calls.