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


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