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

# Ashby

> Manage candidates, jobs, applications, and hiring pipelines from Mantle — track your recruiting workflow without switching tabs

Connect Ashby to let selected agents create candidates, manage applications, track interviews, and query the recruiting
data available to your connected account.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Candidate management" icon="user-plus">
    Create candidates, update profiles, and search your talent pool directly from chat or through an agent.
  </Card>

  <Card title="Application tracking" icon="clipboard-list">
    Move applications through stages, submit feedback, and monitor your hiring funnel in real time.
  </Card>

  <Card title="Job & opening management" icon="briefcase">
    Create and update job postings, manage openings, and track hiring team members across departments.
  </Card>

  <Card title="Interview coordination" icon="calendar-check">
    View interview schedules, list events, and manage interviewer pools without leaving Mantle.
  </Card>
</CardGroup>

***

## Connect Ashby

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Ashby**.
  </Step>

  <Step title="Authorize with OAuth">
    Click **Connect** and sign in to your Ashby account. Grant Mantle the requested permissions to access your
    recruiting data.
  </Step>

  <Step title="Confirm the connection">
    Once authorized, you'll be redirected back to Mantle. The integration status will show as connected.
  </Step>
</Steps>

***

## Agent tools

Add Ashby tools to agents that need them. Their access is limited by the connected account and selected tools.

### Candidates

| Tool              | Description                                       |
| ----------------- | ------------------------------------------------- |
| Create candidate  | Add a new candidate to your talent pool           |
| Get candidate     | Retrieve detailed info about a specific candidate |
| Update candidate  | Edit candidate profile details                    |
| Search candidates | Search candidates by name, email, or tags         |
| List candidates   | List all candidates with optional filters         |
| Add candidate tag | Tag a candidate for easier categorization         |

### Applications & Offers

| Tool               | Description                                        |
| ------------------ | -------------------------------------------------- |
| Create application | Submit a new application for a candidate           |
| Get application    | Retrieve application details and current stage     |
| Change stage       | Move an application to a different interview stage |
| Submit feedback    | Submit interview feedback on an application        |
| Create offer       | Create a new offer for a candidate                 |
| List offers        | List all offers with their current status          |

### Jobs & Openings

| Tool              | Description                                 |
| ----------------- | ------------------------------------------- |
| Create job        | Create a new job requisition                |
| Get job info      | Retrieve details about a specific job       |
| Search jobs       | Search jobs by title, department, or status |
| List job postings | List all published job postings             |
| Create opening    | Create a new opening under a job            |
| List openings     | List all openings with filters              |

### Interviews & Teams

| Tool                   | Description                              |
| ---------------------- | ---------------------------------------- |
| List interviews        | List all interview stages and schedules  |
| List interview events  | View scheduled interview events          |
| Add hiring team member | Add a user to the hiring team for a job  |
| List departments       | List all departments in the organization |
| List users             | List all users in the Ashby workspace    |

***

## Triggers

<Note>
  Automated triggers for Ashby are not yet available. Triggers will be added in a future update — check back soon.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Auto-create candidates from inbound messages">
    When someone shares a candidate profile link in chat, an agent can extract the details, create a candidate in Ashby,
    and attach them to the appropriate job opening — no manual data entry required.
  </Accordion>

  <Accordion title="Daily hiring pipeline summary">
    An agent queries all open applications, groups them by stage, and posts a daily summary to your #recruiting channel
    so the hiring team stays aligned without checking Ashby directly.
  </Accordion>

  <Accordion title="Interview feedback reminders">
    After an interview event, an agent checks whether feedback has been submitted. If not, it sends a reminder to the
    interviewer with a direct link to the feedback form.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth connection failed">
    Make sure you are signing in with an Ashby account that has admin or recruiter permissions. If the connection fails,
    try disconnecting and reconnecting from **Settings → Integrations → Ashby**.
  </Accordion>

  <Accordion title="Agent can't find candidates or jobs">
    Verify the connected Ashby account has access to the candidates and jobs you expect. Permissions in Ashby are scoped
    to what the authenticating user can see.
  </Accordion>

  <Accordion title="Application stage change isn't working">
    Check that the target stage exists in the job's interview plan. The stage ID must match exactly — use the "List
    interview stages" tool to find valid stage IDs.
  </Accordion>

  <Accordion title="Data seems stale or missing">
    Ashby data is fetched in real time via the API. If results look incomplete, confirm the authenticating user's
    permissions haven't changed. Reconnect the integration if needed.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>