Ashby

Ashby is an all-in-one recruiting platform. This toolkit lets Arcade agents read and write recruiting data in Ashby — candidates, applications, jobs, notes, feedback, and interview stage progression.

Capabilities

• Candidate management: Search candidates by name/email, retrieve full profiles (with application IDs), and add plain-text notes (e.g. agent handoffs or summaries).
• Application lifecycle: List applications filtered by job or status, move applications forward or backward through named interview stages, and read submitted feedback/scorecards.
• Job listings: Enumerate the organization's roles, optionally filtered by status.
• Debrief aggregation: Pull a candidate's profile, all notes, and all interview feedback across applications in a single call — no manual chaining required.

Secrets

• ASHBY_API_KEY — An Ashby API key scoped to the permissions required by the tools you use. Generate one in your Ashby account under Settings → Integrations → API Keys. Each key carries granular permissions; the tools in this toolkit require the following depending on usage:

  • Candidates read — searching, reading profiles, listing notes, listing feedback, listing applications, debrief aggregation.
  • Candidates write — adding notes, changing application stage.
  • Interviews read — changing application stage (stage plan lookup).
  • Jobs read — listing jobs.

  Create and scope the key from the Ashby API Keys settings page. Note that Ashby API keys are organization-scoped; the key holder can read or write across all candidates and jobs in the org, so apply least-privilege scoping.

See the Arcade secrets guide for how to store secrets, or manage them directly at https://api.arcade.dev/dashboard/auth/secrets.