Enabling and using the Good Egg integration

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

The Good Egg integration allows talent acquisition teams to initiate background checks and receive updates on the results all within Lever while receiving personal customer support from the Good Egg team.


This is a specialized integration that is built, managed, and supported by the Good Egg team. If you would like more information or help with this integration, please contact Good Egg.

Readers of this article will learn the following:

Setting up the Good Egg 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 Good Egg to install this integration.
  • In Lever, navigate to Settings > Integrations and API > API Credentials
  • Under Lever API Credentials, click Generate New Key

API credentials page in Intergrations and API Lever Settings

  • Record the API Key
    • You will not be able to re-access the key after configuring the settings. You will need to send the API Key to Good Egg.
  • From the list of permissions, grant access to the following:
    • Read candidate
    • Read candidate application
    • Read candidate resume
    • Read posting
    • Read requisition
    • Read user
    • List tags
    • List stages
    • Remove candidate tag
    • Add candidate tag
    • Create opportunity
  • Once you have selected the permissions, name the key (e.g. Good Egg) and add an icon/image, if desired
  • Save the new API key to a secure place

Refer to Lever's help article on generating and using API credentials for more information on granting access via API credentials.

Configuring the Good Egg integration

Notification URL/Web Hook
To ensure that the integration notifies Good Egg about candidate stage changes, configure the 'Candidate Stage Change' webhoook in Lever. The integration supports receiving notifications when only when a candidate's stage changes. It does not support receiving notifications when a candidate is hired.

  • In Lever, navigate to Settings > Integrations and API > Webhooks
  • Toggle the 'Candidate State Change' webhook to the on (green) position, if it is not already enabled
  • Select Add Webhook 

Candidate Stage Change webhook tile in Lever

Good Egg’s system will need the signature token in order to verify incoming webhooks as having originated in Lever. You may use an existing signing token if you have one already, otherwise click Regenerate Token to generate a new web signing token, and securely send it to Good Egg.

Shared Secret Key
When configuring a notification URL you must specify a shared secret key. This key is used to generate a signature, which is then transmitted with the notification. The Good Egg/Lever integration then uses the same shared secret to validate that the message came from Lever. To validate, the Good Egg system must be configured with the same shared secret key as the webhook in Lever. Send your shared secret key to Good Egg.

Disabling the Good Egg integration

  1. In Lever, navigate to Settings > Integrations and API
  2. Under the 'API Credentials' tab, locate the Good Egg API credentials
  3. Click the trash can icon to disable the integration
Was this article helpful?
0 out of 0 found this helpful