Ashby integration

Contents

• What can you do with a Dado-Ashby integration?
• What data is exchanged between Dado and Ashby?
  • Ashby API Permissions needed by Dado
• How to set up the Ashby integration
  • 1. Create a new API key
  • 2. Add your API Key to Dado
  • 3. Confirm which status should trigger a sync to Dado

What can you do with a Dado-Ashby integration?

The Dado <> Ashby integration allows you to use Ashby as a source for importing users and updating user data in Dado. For instance, you can import newly hired team members into Dado, including any relevant data needed for your preboarding and onboarding process.

What data is exchanged between Dado and Ashby?

Ashby data accessible to Dado

Dado connects to Ashby via their API, using an API key generated with a particular set of permissions (see Ashby API Permissions needed by Dado below). If you set up the key with permissions listed below, Dado will only be able to access data about candidates and offers. Please be aware: Dado cannot sync data from fields marked Private in Ashby.

In practice, which data is synced to Dado is determined by you, when you set up Ashby as an import source and select which fields should be imported; and when you specify what status in Ashby should trigger an import into Dado.

Dado data accessible to Ashby

Dado does not sync data back to Ashby, so no data held in Dado would be exposed to Ashby.

Ashby API Permissions needed by Dado

• Candidates module – read data
  • This grants Dado access to read data through the following endpoints:
    • /application.info
    • /application.list
    • /applicationFeedback.list
    • /applicationHiringTeamRole.list
    • /candidate.info
    • /candidate.list
    • /candidate.listNotes
    • /candidate.search
    • /file.info
    • /surveySubmission.list
• Hiring Process Metadata module – read data
  • This grants Dado access to read data through the following endpoints:
    • /archiveReason.list
    • /candidateTag.list
    • /customField.list
    • /feedbackFormDefinition.info
    • /feedbackFormDefinition.list
    • /interviewerPool.info
    • /interviewerPool.list
    • /referralForm.list
    • /source.list
    • /surveyFormDefinition.info
    • /surveyFormDefinition.list
• Offers module – read data
  • This grants Dado access to read data through the following endpoints:
    • /offer.info
    • /offer.list

How to set up the Ashby integration

1. Create a new API Key

• In your Ashby account, go to Admin > Integrations
  • If you do not have access to this screen, please ask a colleague with Organizational Admin permissions to complete these instructions.

• Search for Dado in the Integrations page, and click on the card

  

• A sidebar will appear with a Create API Key for Dado button. Click this button, and copy the API key that appears.

  • You will not be able to access this key after closing this window, so make sure you keep the key somewhere secure

    

• Click on the grey button next to the API Key name to access the Key's settings

  

• You'll be redirected to a new screen. In the sidebar, click the Configure API Key Permissions button

  

• Select the following permissions:
  • Candidates
    • Read
  • Hiring Process Metadata
    • Read
  • Offers
    • Read
  • [Optional] Allow access to confidential jobs and projects
    • select this option if you'd like data synced to Dado about new hires for these confidential jobs

2. Add your API Key to Dado

• Go to Settings > Integrations
• Click on the Ashby card
• Enter your API key and click Save

3. Confirm which status should trigger a sync to Dado

By default, new hires will sync from Ashby to Dado when their offer status is moved to Offer Accepted.

If you need a different status to trigger data syncing to Dado, please let your Dado customer success manager know.