> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ashby

> Connect Ashby to your Atako agents — 26 read and 8 write actions.

Let your agents work with your Ashby ATS — browse jobs, candidates, applications and interviews, add candidates and notes, and move applications through stages.

## Connection

* **Authentication**: API key.

<Note>
  Ashby → Admin → Integrations → API Keys (app.ashbyhq.com/admin/api/keys) → create a new API key. Grant read access to the Candidates, Jobs, Interviews and Organization modules (add write access on Candidates for create/update actions), then copy the key.

  See [Ashby's documentation](https://developers.ashbyhq.com/docs/authentication).
</Note>

## Read actions (26)

| Action | Description |
| - | - |
| `get_application` | Fetch a single application by id. |
| `get_candidate` | Fetch a single candidate by id. |
| `get_department` | Fetch a single department by id. |
| `get_interview` | Fetch a single interview by id. |
| `get_job` | Fetch a single job by id. |
| `get_job_posting` | Fetch a single job posting by id, including its description. |
| `get_offer` | Fetch a single offer by id. |
| `get_user` | Fetch a single Ashby user by id. |
| `list_applications` | List applications in the organization, filterable by status or job. |
| `list_archive_reasons` | List archive reasons, needed when archiving an application. |
| `list_candidate_notes` | List all notes on a candidate. |
| `list_candidate_tags` | List all candidate tags in the organization. |
| `list_candidates` | List candidates in the organization. |
| `list_departments` | List departments in the organization. |
| `list_interview_schedules` | List scheduled interviews, filterable by application or stage. |
| `list_interview_stages` | List the interview stages of an interview plan, in order. |
| `list_interviews` | List interviews in the organization. |
| `list_job_postings` | List published job postings, filterable by location or department. |
| `list_jobs` | List jobs, filterable by status. |
| `list_locations` | List office locations in the organization. |
| `list_offers` | List offers, filterable by application. |
| `list_sources` | List all candidate sources in the organization. |
| `list_users` | List Ashby users in the organization. |
| `search_candidates` | Search candidates by exact email and/or name. |
| `search_jobs` | Search jobs by title or requisition id. |
| `search_users` | Find an Ashby user by email address. |

## Write actions (8)

| Action | Description |
| - | - |
| `add_candidate_tag` | Add an existing tag to a candidate. |
| `change_application_source` | Change an application's source. |
| `change_application_stage` | Move an application to a different interview stage (or archive it with a reason). |
| `create_application` | Create an application for an existing candidate on a job. |
| `create_candidate` | Create a new candidate. |
| `create_note` | Add a note to a candidate's profile. |
| `update_application` | Update an application's source or credited user. |
| `update_candidate` | Update an existing candidate's profile fields. |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: July 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.