Skip to Content
Sign Up
IntegrationsAshby

Ashby

Connect Ashby and your assistant can work with your recruiting data — candidates, applications, jobs, interviews, offers, and more — so hiring workflows like candidate research, interview prep, and pipeline updates happen without leaving Town.

What’s included

With Ashby connected, your assistant can:

  • Search and read recruiting data — candidates, applications, jobs, job postings, interviews, offers, openings, projects, and sources
  • Move candidates through your pipeline — create candidates and applications, change stages, add notes and tags
  • Work with interviews — list interview plans, stages, and schedules, and create or update schedules
  • Manage offers — create, update, approve, and progress offers
  • Administer your workspace — create or update jobs and job postings, manage custom fields, manage hiring teams, cancel sequences, push candidates to your HRIS, and anonymize candidates

Connecting Ashby

Ashby connects with an API key. Only an Ashby Organization Admin can create one, and it takes an admin about 2 minutes. If you don’t have admin access, send these steps to your Ashby admin (usually recruiting ops) and ask them to share the key with you.

Step 1: Create an API key in Ashby (admin only)

  1. In Ashby, go to Admin → Integrations → API Keys 
  2. Click + New, name the key (for example, “Town”), and click Create API key
  3. Choose permissions. New keys start with no access, so check each area you want your assistant to use and choose Read or Write. Only grant Write where you want your assistant to make changes, like moving candidates between stages or adding notes. (We recommend giving both read and write access because the most useful recruiter routines often involve keeping your ATS up-to-date.)
  4. Under Other permissions, you can also allow access to confidential jobs and projects
  5. Click Save and continue, then copy the key. Ashby only shows it once, so save it before closing the window.

For Ashby’s full walkthrough, see How do I generate an API key? 

Step 2: Connect Ashby in Town

  1. Go to Integrations
  2. Find Ashby and click Connect
  3. Paste your API key and return to Town

Your assistant can only reach the data and actions the API key allows. To change what it can do, edit the key’s permissions in Ashby. To revoke access, disable the key in Ashby.

What your assistant can do

CapabilityWhat it doesMakes changes?
Search candidates and jobsFind candidates, jobs, and projectsNo
Read applications and historyView application details, feedback, and historyNo
List interviews and schedulesSee interview plans, stages, events, and schedulesNo
Read offers and openingsView offer and opening detailsNo
Create and update candidatesAdd candidates, notes, tags, and filesYes
Manage applicationsCreate applications, change stages, submit feedbackYes
Manage interview schedulesCreate, update, or cancel schedulesYes
Manage offersCreate, update, approve, and progress offersYes
Manage jobs and postingsCreate or update jobs and job postingsYes
Manage custom fieldsCreate custom fields and set valuesYes
Manage hiring teamsAdd or remove hiring team membersYes
Push to HRISSend application data to your HRISYes
Anonymize candidatesPermanently anonymize a candidate’s dataYes

Use cases

  • Candidate research — “pull up the candidate profile and latest feedback for my 2pm interview.”
  • Pipeline updates — move an application to the next stage after a debrief.
  • Interview prep — combine Ashby interview briefings with calendar context.
  • Hiring summaries — “summarize this week’s activity across my open roles.”

Good to know

  • Recruiting data is sensitive — use approval-required tool settings in routines that change candidate or offer data.
  • Some write tools are destructive or reach external systems (anonymizing candidates, pushing to your HRIS) — keep those approval-required.
  • Your assistant sees only what the API key allows. If something seems to be missing, check the key’s permissions in Ashby.
Last updated on
AsanaAttio