Lever – How do I create a candidate?

In this tutorial, you'll learn how to write candidates to Lever using an integration with Bindbee.

Step 1: Start by accessing the integration with Lever on Bindbee that you've already created.

Step 2: Copy the connector token from your synced Lever account.

Step 3: Next, copy the API key.

Step 4: Call the remote users API to get all the remote users for this Lever instance. Repeat this process for jobs and job interview stages.

Step 5: Navigate to the right candidate API. Ensure that the correct headers are filled in. The headers should include the X connector token and the authorization.

Step 6: Confirm the headers. Now, take a look at a sample body for writing a candidate. We are including the expected JSON body for writing candidate in Lever here:

{
   "data":{
      "first_name":{
         "type":"string",
         "description":"The candidate's first name.",
         "required":false
      },
      "last_name":{
         "type":"string",
         "description":"The candidate's last name.",
         "required":false
      },
      "company":{
         "type":"string",
         "description":"The name of the company where candidate has applied.",
         "required":false
      },
      "locations":{
         "type":"list",
         "description":"The location of the candidate.",
         "required":false
      },
      "phone_numbers":{
         "type":"list",
         "description":"The candidate's phone numbers.",
         "required":false
      },
      "email_addresses":{
         "type":"list",
         "description":"The candidate's email addresses.",
         "required":false
      },
      "urls":{
         "type":"list",
         "description":"The candidate's URLs. This can include a personal website, LinkedIn profile, or other relevant URLs.",
         "required":false
      },
      "job_interview_stage_id":{
         "type":"UUID",
         "description":"The job interview stage id for the candidate",
         "required":false
      },
      "job_id":{
         "type":"UUID",
         "description":"The job id for the candidate",
         "required":false
      }
   },
   "remote_user":{
      "type":"UUID",
      "description":"The ID of the user on whose behalf the operation is performed. Users can be obtained from /api/ats/v1/remote-users endpoint.",
      "required":true
   },
   "additional_attributes":{
      
   },
   "custom_fields":{
      
   }
}

Note that not all parameters are compulsory. The only mandatory parameter is the remote user ID, which is the ID of any remote user making this change. For this example, we'll use Aditya.

Step 7: Copy Aditya's ID

and paste it in the appropriate field.

Step 8: Also, grab a job ID and a job interview ID.

Step 9: If you only have one job, simply grab the ID.

Step 10: Choose a job interview stage, such as "offer" or "new applicant." You can set this to anything you want. Paste this information in the appropriate field and click "send."

Step 11: You should now see that a candidate has been successfully created. Head over to your Lever instance and refresh the page.

Step 12: You should see a new lead, which was the option you selected.

Step 13: It may take a moment for Lever to refresh.

Step 14: Once refreshed, you'll see the new applicant, John Doe, that you just created.

You can now view all the information about the new candidate. In this example, the candidate was created by Aditya and has opted for the SDE-1 job. That's it! You've successfully written a candidate to Lever using Bindbee.