> ## 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.