# Ashby

> Source: https://truto.one/docs/integration-guides/ashby/

Ashby connects with an API key. The key's module permissions decide which endpoints Truto can call.

## Install the Ashby integration

Install Ashby from [Available integrations](https://app.truto.one/integrations/available/908c1061-ef57-45ea-bc69-3fa004983246) in each environment you connect accounts from.

## Create an API key

1. In Ashby, go to **Admin** → **Integrations** → **API Keys** and click **New**.
2. Enter a name for the key.
3. Give the key read or write access to each module you need. Hover over the info icon next to a module to see the endpoints it covers.
4. Click **Save and Continue** and copy the key. Ashby doesn't show it again; if you lose it, create a new one.

A call to an endpoint the key has no permission for returns `403` with `missing_endpoint_permission`. See Ashby's [Authentication](https://developers.ashbyhq.com/reference/authentication) reference for which endpoints each module covers.

## Connect an Ashby account

1. Click **Connect Account**.
   ![Click Connect Account](https://docs-assets.truto.one/truto-connect-account.png)
2. Enter a Tenant ID. This can be any ID you choose. Click **Get connection link**.
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)
3. Open the generated link. You can also share it with your customer so they connect their own Ashby account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)
4. Select **Ashby**.
5. Fill in the form and click **Connect**:

   | Field | Required | What to enter |
   |---|---|---|
   | **API Key** | Yes | Your Ashby API key. See [Create an API key](#create-an-api-key). |
6. Close the tab when you see the connection successful message. The new account appears under **Integrated Accounts**. Click its Account ID to see its details and make API calls.