Skip to main content

​
About Ashby

Ashby is an all-in-one recruiting platform that helps companies streamline their hiring process. It provides tools for applicant tracking, interview scheduling, analytics, and candidate relationship management.

​
What the Ashby integration enables

CapabilityDescription
Workflow AutomationBuild Serval workflows to automate anything accessible via Ashby’s REST APIs
All resources exposed by the Ashby API are available to Serval workflows using API key authentication.

​
Ashby configuration (in Ashby)

​
Prerequisites

Before configuring the Ashby integration in Serval, ensure you have:
  • An active Ashby account
  • Sufficient permissions to generate API keys
  • Access to the Admin panel in Ashby

​
Generate an API Key

1

Access the API Keys page

  1. Log in to your Ashby account at https://app.ashbyhq.com
  2. Navigate to Admin → Integrations → API Keys
If you don’t see the API Keys option, you may not have admin permissions. Contact your Ashby administrator.
2

Create a new API key

  1. Click the + New button to open the API key setup wizard
  2. Enter a descriptive name for your key (e.g., “Serval Integration”)
  3. Optionally, select your Integration Partner if applicable
3

Configure endpoint permissions

By default, the API key will have no permissions. Configure the appropriate access levels:
  1. Use the checkboxes to allow access to each module
  2. Determine whether read or write access should be provided for each module
  3. Hover over the i icon beside each module to view the specific endpoints that can be accessed
  4. Optionally, enable access to confidential jobs if needed for your workflows
Grant only the minimum permissions necessary for your intended use case. You can always update permissions later if needed.
4

Save and copy the API key

  1. Click Save and Continue to finalize your scope selections
  2. On the final step, copy your API key and store it securely
The API key provides access to your Ashby data. Store it securely and never commit it to version control. Anyone with access to this key can perform actions within the granted permissions.

​
Serval configuration

Once you have your Ashby API key, follow these steps to configure the integration in Serval:
1

Navigate to Ashby integration

  1. In Serval, go to Applications → Available → Ashby
  2. Click Connect
  3. The Ashby configuration form will appear
2

Enter configuration details

Fill in the following fields:
FieldDescriptionExample
Instance NameA descriptive name for your Ashby instanceAshby or My Company Ashby
API KeyThe API key you generated in Ashby••••••••••••••••••••
The Instance Name is used to identify this integration within Serval. Choose a name that makes sense for your organization, especially if you plan to connect multiple Ashby instances.
3

Submit the configuration

  1. Click Submit to complete the integration setup
  2. Serval will verify the connection by making a test API request
  3. Once verified, you can start building workflows with Ashby

​
Using Ashby in workflows

Once connected, you can use Ashby in your Serval workflows to automate recruiting processes:
  • Candidate management: Create, update, and retrieve candidate information
  • Application tracking: Monitor and manage job applications throughout the hiring pipeline
  • Interview scheduling: Automate interview coordination and scheduling
  • Job postings: Manage job openings and postings
  • Analytics and reporting: Access hiring metrics and performance data
The Ashby integration provides access to all endpoints in the Ashby REST API. Explore the API documentation to discover all available capabilities and build powerful recruiting automations.
Need help? Contact support@serval.com for assistance with your Ashby integration.