Skip to content

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 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 reference for which endpoints each module covers.

Connect an Ashby account

  1. Click Connect Account. Click Connect Account

  2. Enter a Tenant ID. This can be any ID you choose. Click Get connection link. Get connection link

  3. Open the generated link. You can also share it with your customer so they connect their own Ashby account. Share connection link

  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.

  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.