Skip to main content
Connect your Ashby ATS so approved offers in Ashby automatically appear in ClearOffer as unpublished offers that you can review and send.

What you'll get

Approved Ashby offers automatically appear in ClearOffer, with optional custom field mapping.

​
Prerequisites

  • Ashby admin access (to create an API key)

​
Connect Ashby

1

Open Ashby

Go to Ashby and navigate to the Admin panel.
2

Navigate to Integrations

From the left sidebar, click on Integrations.
3

Search for ClearOffer

On the Integrations page, search for ClearOffer.
4

Create API Key for ClearOffer

Click on the ClearOffer card to open the integration settings, and then click on Create API Key for ClearOffer.
5

Copy the API Key

Copy the API Key and save it somewhere safe and secure.
6

View API Key Settings

Close the API Key modal, then click on View API Key Settings button.
7

Update API Key Settings

Within the API Key Settings, under Other Permissions, check the box for Allow access to confidential jobs and projects?, and then click on the Save button.
When creating your Ashby API key, if you want to scope the API key based on principle of least privilege, ensure it only has the following permissions:
  • Candidate Read
  • Hiring Process Metadata Read
  • Offers Read and Write
  • API Key Read and Write
  • “Allow access to confidential jobs and projects?” checked Ashby API Key Settings
8

Open ClearOffer

Open ClearOffer and click on the Company toggle in the sidebar, then click on Integrations to open the Integrations page.
9

Setup Ashby Connection

In the Ashby card, click Connect Ashby, and paste the API key you copied earlier.
Treat your API key like a password. Do not share it in chat or tickets.
10

Choose events

Select which Ashby events should sync to ClearOffer:
  • Offer Create — create a new ClearOffer when a new offer is created in Ashby
  • Offer Update — update the matching offer in ClearOffer when it changes in Ashby
11

Configure

Click Configure Integration. ClearOffer will validate your key and automatically create the required webhooks in Ashby.
You should see a Connected badge on the Ashby card once setup is complete.

​
What gets synced

Data TypeWhat Gets Synced
Basic InfoName, email, role, start date
CompensationBase salary, currency
Custom fieldsAny custom fields you map via Custom Field Mapping (Equity details, department, location, manager, etc).
Only offers in Ashby that are ready for candidate delivery are synced. Drafts or unapproved offers aren’t imported.

​
Verify the connection

  • Create or approve a test offer in Ashby
  • In ClearOffer, check your Offers list for a new unpublished offer
  • If Offer Update is enabled, make a small change in Ashby and confirm it updates in ClearOffer

​
Troubleshooting

Regenerate the key in Ashby with the required permissions and re-enter it in ClearOffer.
  • Confirm the offer in Ashby is approved and ready for candidate delivery (status is WaitingOnCandidateResponse)
  • Ensure you enabled the relevant event (Offer Create or Offer Update)
Follow the in-app manual setup steps or contact support with a timestamp of your attempt.

​
Next steps

Map your Ashby custom fields to ClearOffer so additional information (like equity details, department, location, welcome messages, etc) is populated automatically.

Set up custom field mapping

Map Ashby custom fields to ClearOffer fields to enrich synced offers.