Ashby

🚀 Quickstart
🔗 Useful links
🚨 API gotchas

Create an integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Ashby.

Authorize Ashby

Go to Connections -> Add Test Connection -> Authorize, then enter your Ashby API key. Later, you’ll let your users do the same directly from your app.

Call the Ashby API

Let’s make your first request to the Ashby API (fetch a list of all candidates in an organization). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl -X POST "https://api.nango.dev/proxy/candidate.list" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"limit": 10}'

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

// Lists all candidates in an organization.
const res = await nango.post({
  endpoint: '/candidate.list',
  providerConfigKey: '<INTEGRATION-ID>',
  connectionId: '<CONNECTION-ID>',
  data: {
    limit: 10
  }
});

console.log(res.data);

Or fetch credentials dynamically via the Node SDK or API.

✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Next step: Embed the auth flow in your app to let your users connect their Ashby accounts.

Topic	Links
Authorization	Guide to connect to Ashby using Connect UI
General	Ashby Website
	Ashby Dashboard
Developer	How to generate an API key
	Ashby API docs
	API Authentication
	API Key Endpoint Permissions

Contribute useful links by editing this page

Ashby gives you only an API Key but uses Basic auth for the API. Pass the API Key as the username to Nango and leave the password blank.
The apiKey.info scope is required for the api key to pass verification.

Contribute API gotchas by editing this page

Questions? Join us in the Slack community.

API Guides

APIs & Integrations