---
title: Covey
slug: covey
docTags: rl7p3XLQknqPB1UQ70cu_,MOnH3HaRn-OOSc_X5SrPJ
createdAt: 2025-07-10T11:42:30.303Z
---

## Create Covey Candidate Source

When setting up the API Key, there will be an option to set a default souce so that all applications created with the API key have a specific source added

To set that up, Sign into Ashby and click Admin in the top navigation bar

Navigate to Organization Setup > Candidate Sources

Click `+ New Source` in the upper right corner

Set the name to Covey and set the source type to one of your choosing — below is an example:

::Image[]{src="https://lh7-us.googleusercontent.com/So-52NIIvMxQfKT9r67eZ0-owYrpH_wjztI_OOpAons1Igycy92ZSwn7KjtiAewCH4-YlhrskM9KT9rBwB-2lghfqOSX5XIguIfyXWPQ5WcHMz8svixj-IVQgt2s17iSM3cc0zc35Kjk2Zy3cTFAwYE" size="42" width="288" height="300" position="center" darkWidth="288" darkHeight="300" showCaption="false"}

Click `Create`

## API Key Setup

Sign into Ashby and click Admin in the top navigation bar

Navigate to Integrations > API Keys

![](https://lh7-us.googleusercontent.com/3Dw33bi4ai1rFtk5afjtxmNfioAx1lVUZSt4-xaX1bGHejM0SuCT2iIMgjZmY1fmH3CD4yc-FZ3Gl-xkEqXwG93348-8I4CGOnvMtZ6acVzjluSax3rah0a5DdU-fSq_la3QJMOahwQJe6nfSGob4zw)

Click `+ New` in the upper right corner

![](https://lh7-us.googleusercontent.com/qPAN01XSRzio6db31HnDpSl46eqUdyVrQiQUAZQ2KDdUk-Elu_fOYb51oZXjqZWjJ8hW9rjOSZfkijj0nZs_QaCzgUtMIYlv2978bvQdfxHc5QMei3ENALqREKUUB8-zqJq_ycXxNXHNB9WdEdLjOYU)

Add a name for the new API Key (e.g. Covey API Key), click Create API Key

![](https://lh7-us.googleusercontent.com/oH431fY_1uHDTSIFsnHAPQioSun0TzJfVBs63uyPPr7evM5g0i75xR_KN_-PKj4oAbWKUA15xfgjNBGz6frnlkXdgcQQAZHIGBqpj6F8KapJ5t9NH440q53flD2UnUNgEziDKROYp1tkBrGn5-7TlZM)

Grant the following permissions to your API key:

- Jobs: Read/Write
- Candidates: Read/Write
- Interviews: Read
- Hiring Process Metadata: Read/Write
- Organization: Read
- Offers: Read

![](https://lh7-us.googleusercontent.com/EU4j83VvcJTdwRl1Wn6C8ov9hJTR5wO04rPvYONEmc2Ik9qH2ChCmTvqLgDPqPCow767Yfq45Wd-GEGvdzCIUmBUkaxS7MeL9uq4ZWMDct8c24HHdnmQ68-3hMEXOcl9ppoIfM7jXdGg90zaQi08zhI)

Click `Save and Continue`

Ashby will display an API key — copy this API key

![](https://lh7-us.googleusercontent.com/Mv9UVmlJ2RRPn5HbYrMTfPTOGDJypw2Q58L-AyO9PSW7um6kdvV3Pg07sOr8ouU6sCvQXmOh1jNj5AjsDb--EOUxHh89st-gq9yF7JqOPhwD8VwYZ2o6s7Oh5DkAr2Wb57Ka-GcMc-o1-YlHSPn_VD8)

Click `Copy and Close`

Click into the newly create API Key from the Active API Keys table

Set Default Source to Sourced: Covey

![](https://lh7-us.googleusercontent.com/ViWDEVVneqnSAtKmD-PcEXGjFaU6C7aRcZIu1HxESEsORLEP9_04xt9h9p3eZ6czWTP8JSRHv15JHIQWSi6whHYV5GazrvSVC-1SNefwnebXi4BvCScvizLGTVsn1l0sUNtX_Kr4HzFmISrVUxmXFF4)

Close the API Key modal

Go to the [Admin Settings Integration tab in Covey](https://getcovey.com/account/company/settings)

Select Ashby from the dropdown

![](https://lh7-us.googleusercontent.com/bVkDiKXYYBmesw50LcajZUeeiCj-PLyeJHWUngmffWVOHQEc73DM-lPscNHvJCgbwDVBTYpaTmtAu5XinCKe4V19DZcio6th78cjK_XP2DWdTXfa-A-5LZGcMt4tTyeew0o0nw4SCpl6EhrPtw5PJ4E)

Click `Connect ATS`

In the Select Integration Search input, type in Ashby, and click `Ashby`

::Image[]{src="https://lh7-us.googleusercontent.com/kpq36g-rVedDPcYGVxpFV_eTrwgIlpUF_50zuTVc7-L6Wj7neFAV52P0W2HC_YE9V1QGG92B0McYWRTtzl84wS_jMT5z-PVtnlnjx321hAIAUNZwExYLsp9VYnd0LVB3BN_0GlqWymjLztK6aaSRdQ4" size="50" width="810" height="1492" position="center" darkWidth="810" darkHeight="1492" showCaption="false"}

Read through and click `Continue`

Paste your Ashby API key and click `Submit`

::Image[]{src="https://lh7-us.googleusercontent.com/V0aBNxkplp0F0AqFxx4GN_j1vBimLAazc9D2oJPLP0lAPnLfV9a62X0i3ZVAAXjmirZrquiCshypWAP6vKqFc7oRHdY0CPUxXxPbQG00UnMZxmLVWHdwpwouqCYEcLsTTr26boPSWy9IA7nEuVv58WI" size="56" width="722" height="1272" position="center" darkWidth="722" darkHeight="1272" showCaption="false"}

Once the API key has been submitted, wait until a confirmation message shows

::Image[]{src="https://lh7-us.googleusercontent.com/DNIivd7K0ZtqdFL8_yLOkcn39JQHEyy49wuW4o53BUi9xzOAE-G50z-yJI5ZSqU5ujLXUSBA9LIbs8fF2Z40rFdeG3vnnM7GCQcLVe2WATTXESxsgN4ypS3kr7iA8ziX6kId1sqsRoxWvbyQrNvUUps" size="30" width="500" height="428" position="center" darkWidth="500" darkHeight="428" showCaption="false"}

Continue to follow the instructions in the modal

## Create Covey User in Ashby

This user will be used in API calls that aren’t associated with a specific user so that there is a clear audit trail of all actions taken in Ashby.

From [the Ashby admin settings page](https://app.ashbyhq.com/admin/overview), click Organization Setup > Employees

Click New in the top right corner

Set the name to Covey

Set the email address to covey@ (e.g. [covey@getcovey.com](mailto\:covey@getcovey.com))

Click Actions > `Activate`

Click Permissions

Under Global User Role, set role to Organization Admin