Ashby

Ashby is a recruiting platform; this toolkit lets Arcade agents read and write recruiting data — candidates, applications, jobs, notes, feedback, and interview stages — via the Ashby REST API.

Capabilities

• Candidate management: Search candidates by name/email, fetch full profiles, read and add plain-text notes, and pull a combined debrief bundle (profile + notes + scorecards) in one call.
• Application lifecycle: List applications (filtered by job and/or status), move applications forward or backward through named interview stages, and archive/reject applications with a resolved reason.
• Feedback & scorecards: Read submitted interview feedback and scorecards on any application — useful for pre-debrief synthesis.
• Job listing: Enumerate the organization's job records, optionally filtered by status.

Secrets

ASHBY_API_KEY — An Ashby API key scoped to the permissions your agent needs. Ashby issues API keys per organization; generate one in Settings → Integrations → API Keys inside your Ashby admin panel. Each key carries explicit permission grants — the tools in this toolkit require combinations of Candidates read, Candidates write, Interviews read, and Jobs read depending on which tools you use (tool docstrings list the exact permissions required). Keys with insufficient permissions will return authorization errors at call time. See Ashby's API key documentation for creation steps.

Store the key in Arcade at https://api.arcade.dev/dashboard/auth/secrets and reference it as ASHBY_API_KEY. For full guidance on configuring secrets in Arcade, see https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets.