ashby

name

ashby

description

Ashby is an all-in-one recruiting platform that combines applicant tracking, recruiting CRM, scheduling, sourcing, and analytics, with embedded AI and automation to help teams manage and scale hiring workflows from startups to large enterprises. Read and write Ashby data through One: candidates, locations, openings, applications, offers, departments and more, 177 actions with real parameter documentation. Use whenever the user asks to look something up in Ashby, create or update a record there, or build code against the Ashby API.

Ashby through One

Ashby is an all-in-one recruiting platform that combines applicant tracking, recruiting CRM, scheduling, sourcing, and analytics, with embedded AI and automation to help teams manage and scale hiring workflows from startups to large enterprises.

One exposes Ashby through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform ashby if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Ashby is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Ashby account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Candidates

Action	Method	Path	Action id
Add a Candidate to a Project	POST	/candidate.addProject	conn_mod_def::GMPpWrA2xG4::eLaQJRJbQKCLGwHd-5IAYA
Add Tag to a Candidate	POST	/candidate.addTag	conn_mod_def::GMPpWrIz98E::yaOowODFTdKoSp8WGlTZ7g
Create a Candidate	POST	/candidate.create	conn_mod_def::GMPpWzESRrU::bwzuhdxeQP-i09f3bLBeuQ
Get Candidate Details	POST	/candidate.info	conn_mod_def::GMPpWy9Vh3U::KmvGbme7RdCCfJ1T7-puSQ
List Candidates	POST	/candidate.list	conn_mod_def::GMPpWyZ3NXw::Bs2cCk9LTquFgHKuhfYKMg
List Fraud Checks for a Candidate	POST	/candidate.listFraudChecks	conn_mod_def::GMPpW7R9mFg::pSRsOA9DT1-2aWAXXXYxQA
Remove a Tag from a Candidate	POST	/candidate.removeTag	conn_mod_def::GMPpXBo9_98::i8ZQkyhFRHqRqpkouyiDMA
Search Candidates	POST	/candidate.search	conn_mod_def::GMPpXDcgNfI::JGNIW9SzQiqTBHm4Sohq6Q
Set Fraud Status for a Candidate	POST	/candidate.setFraudStatus	conn_mod_def::GMPpXC4ej1E::XtBZ1xTrSE2fQYi36gIDVQ
Update a Candidate	POST	/candidate.update	conn_mod_def::GMPpXBqHukQ::1dJ4g03bR2SOKgOAupTDUQ
Upload File for a Candidate	POST	/candidate.uploadFile	conn_mod_def::GMPpXMK1Wd8::AUgFnIEmSfyKrtdmGpDQAw
Upload Resume for a Candidate	POST	/candidate.uploadResume	conn_mod_def::GMPpXKuK56s::uFtvwUMKSKWht8m0s05cqw

Locations

Action	Method	Path	Action id
Archive a Location	POST	/location.archive	conn_mod_def::GMPpYyOr_rU::uI1Y9YGoTuOroeTuJC7KrA
Create a Location	POST	/location.create	conn_mod_def::GMPpYyP3ckA::5tZUijJLQjisLetvBwHupQ
Get Location Info	POST	/location.info	conn_mod_def::GMPpY388swk::4dczoprdT3a5xdZtYl_ukg
List Locations	POST	/location.list	conn_mod_def::GMPpYylshXE::apzZOXUuRw6GsYJ73ClKIQ
Move a Location	POST	/location.move	conn_mod_def::GMPpY9znuXQ::ScD1yA33Rx2SFZOYgmBDfA
Restore a Location	POST	/location.restore	conn_mod_def::GMPpZAD4Fuo::azfjsNN0TICATEUvEvZSNw
Update a Location Address	POST	/location.updateAddress	conn_mod_def::GMPpY-pgY9w::41aJaK2nS2C7Nyj2LLR1Zw
Update a Location Name	POST	/location.updateName	conn_mod_def::GMPpY-M_CQI::aR8zGU2vT76edcIcf5a3AA
Update a Location's External Name	POST	/location.updateExternalName	conn_mod_def::GMPpY97gW5E::D8s9hpdFSJWfZG6Tpmsq9w
Update Workplace Type for a Location	POST	/location.updateWorkplaceType	conn_mod_def::GMPpZF1bVoM::rhxBGut_QzuXQccSNGQEOg

Openings

Action	Method	Path	Action id
Add Job to Opening	POST	/opening.addJob	conn_mod_def::GMPpZbV9b0o::WBo3b0m2TGK-CqCCE-q5Iw
Add Location Using Opening	POST	/opening.addLocation	conn_mod_def::GMPpZbRx0Go::PE1vpeoqQCuVRANwqLeWhA
Create an Opening	POST	/opening.create	conn_mod_def::GMPpZeoTDpA::Mb82dBAvS3i24F74OIMprw
List Openings	POST	/opening.list	conn_mod_def::GMPpZk92fRA::HqDez-4BQXiu18ZEOV0QGw
Remove a Job from an Opening	POST	/opening.removeJob	conn_mod_def::GMPpZxR5YiA::GsDL7RquRLeQZ4V5I4la_w
Remove a Location from an Opening	POST	/opening.removeLocation	conn_mod_def::GMPpZlHVLx0::kvqHI8R2QxyTy-7rvRRPWw
Search Openings	POST	/opening.search	conn_mod_def::GMPpZkqMDK0::7pFuDEMgQqK6oJiAPYu2EQ
Set Archived State for an Opening	POST	/opening.setArchived	conn_mod_def::GMPpZ3X0EC4::Xx4BSSJ5QHOrzsKxtKdv_g
Set Opening State	POST	/opening.setOpeningState	conn_mod_def::GMPpZ4N3TgE::sBGBzhIYQKGYGeicORtOSA
Update an Opening	POST	/opening.update	conn_mod_def::GMPpZ4UHAJ0::zXUS4At-TLqqgXPMGnXRXQ

Applications

Action	Method	Path	Action id
Add a Hiring Team Member to an Application	POST	/application.addHiringTeamMember	conn_mod_def::GMPpV1aVK24::_WOqzWlOTPSHiP8cO__HeQ
Change an Application's Source	POST	/application.change_source	conn_mod_def::GMPpV9RHduw::8N249LV_R-KGiif57u2pzQ
Change Stage for an Application	POST	/application.change_stage	conn_mod_def::GMPpV10498s::AAVChC5KQG-hH26Tw4QqqQ
Create an Application	POST	/application.create	conn_mod_def::GMPpWDnzmp4::0AYsu89zSpuXtDSGd3k5yA
Delete an Application	POST	/application.delete	conn_mod_def::GMPpWDjGO_s::q1s_nne4T72AiniWzgoT_A
List Applications	POST	/application.list	conn_mod_def::GMPpWD32rCg::ejgYRFvGSLWwmT3N-ePqVA
Remove a Hiring Team Member from an Application	POST	/application.removeHiringTeamMember	conn_mod_def::GMPpWKwehgg::oHQ2cuhmQ7GGBmw1JqSqGg
Transfer an Application	POST	/application.transfer	conn_mod_def::GMPpWKOffJs::HnwQ1pNvRBq32ckKeWqCrw
Update History for an Application	POST	/application.updateHistory	conn_mod_def::GMPpWRvhWLQ::7fCZfl-LQ6evgJMZ4HBY2w

Offers

Action	Method	Path	Action id
Approve an Offer	POST	/offer.approve	conn_mod_def::GMPpZJMjT7M::OtKcRIgiTcSR5NvICgVD9A
Create an Offer	POST	/offer.create	conn_mod_def::GMPpZGrsFBc::LEbqhtbGTPuqvQZHUUrTDQ
Get Offer Details	POST	/offer.info	conn_mod_def::GMPpZFzaOxg::w9ZeWT39Q9G0lnktp26bFw
List Offers	POST	/offer.list	conn_mod_def::GMPpZUrHMSM::z1_VeqfbTfSo8Mlcot5AzA
Set Decided At for an Offer	POST	/offer.setDecidedAt	conn_mod_def::GMPpZP-6DsM::u_mmPCm6Qj2p8rz8BA9noQ
Set Offer Status	POST	/offer.setStatus	conn_mod_def::GMPpZPCqy0M::s0THUkVVRUCYkjJ0f4nmvA
Start Approval Process for an Offer	POST	/offer.startApprovalProcess	conn_mod_def::GMPpZQXcVLA::EtgMm8_7QLaCve8ReADonA
Update an Offer	POST	/offer.update	conn_mod_def::GMPpZa18p8A::zuPCRHkHQ1uvmtYKz7ZWzw

Departments

Action	Method	Path	Action id
Archive a Department	POST	/department.archive	conn_mod_def::GMPpXbPsRhg::135GtKHVTTuWNrHWJVJvWQ
Create a Department	POST	/department.create	conn_mod_def::GMPpXbB1EPI::SZ8aO5mlR1-krqBaFwIzQg
Get Department Details	POST	/department.info	conn_mod_def::GMPpXmKzufY::bNSyEs8_RWaumU9siNkSoQ
List Departments	POST	/department.list	conn_mod_def::GMPpXmLU6iM::upyzhdUTQR-2Xvpt4ZvJdQ
Move a Department	POST	/department.move	conn_mod_def::GMPpXmABUvs::pOHpDdMLSbmC62cccleDQg
Restore a Department	POST	/department.restore	conn_mod_def::GMPpXnSuVcM::kOgRPfhuRlmE8qtxTNhhFQ
Update a Department	POST	/department.update	conn_mod_def::GMPpXnaCEP8::eZv7FWprSMafPydWZx9TZA

InterviewerPool

Action	Method	Path	Action id
Add a User to an Interviewer Pool	POST	/interviewerPool.addUser	conn_mod_def::GMPpYImirkY::X6NC79RASBuCennefQgb5g
Archive an Interviewer Pool	POST	/interviewerPool.archive	conn_mod_def::GMPpYOrsK9s::gePXi_kPS727GB5afZz4Yw
Create an Interviewer Pool	POST	/interviewerPool.create	conn_mod_def::GMPpYO2_82E::egz9TAzqSqSTp6ISXj6Y8w
Get Information About an Interviewer Pool	POST	/interviewerPool.info	conn_mod_def::GMPpYSZZ8Nk::FiOm2an4QiOtO9hKcqT5ZQ
Remove a User from an Interviewer Pool	POST	/interviewerPool.removeUser	conn_mod_def::GMPpYPMbCP8::FQS05qDoT46D_D-0q7nInQ
Restore an Interviewer Pool	POST	/interviewerPool.restore	conn_mod_def::GMPpYY7_g5E::iqGXfBWHTgKmxG_EwkXSpg
Update an Interviewer Pool	POST	/interviewerPool.update	conn_mod_def::GMPpYa1faX4::vYIxN-CdQZGHoj2UrdS69A

Jobs

Action	Method	Path	Action id
Create a Job	POST	/job.create	conn_mod_def::GMPpYZRAmSU::_zOiZ4b5SHq6FivTED-x4w
Get Job Info	POST	/job.info	conn_mod_def::GMPpYakL2a8::aYJunI5LTH2r4ZYXpEC8Tw
List Jobs	POST	/job.list	conn_mod_def::GMPpYZGrDjg::p3Ac7cOYRZy6H7m0moyjcg
Search Jobs	POST	/job.search	conn_mod_def::GMPpYglGuPk::xrvntv0SSnOWDuv6cwr2qw
Set Status for a Job	POST	/job.setStatus	conn_mod_def::GMPpYkzEGQg::l0FighnLQQWJZTae4mzf0A
Update a Job	POST	/job.update	conn_mod_def::GMPpYg4-LNQ::a9KPZ07vTgGFqwynXU3jEg
Update Compensation for a Job	POST	/job.updateCompensation	conn_mod_def::GMPpYi-WBV4::yLJWwWrfR0-TUN4ll2BtAQ

Application

Action	Method	Path	Action id
Change Source for an Application	POST	/application.changeSource	conn_mod_def::GMPpV2iArmU::YAP7iyymSnOoVtYi9HOSDw
Change Stage for an Application	POST	/application.changeStage	conn_mod_def::GMPpWDpZpxI::87Eqdh0nQqSprxCvJn2TZQ
Get Application Info	POST	/application.info	conn_mod_def::GMPpWDcFYyk::tYoSaYGfSs6-4GPhneFx-w
Update an Application	POST	/application.update	conn_mod_def::GMPpWKw_YuU::NeMP1P1TQx-KVVm__bVA4w

CustomField

Action	Method	Path	Action id
Create a Custom Field	POST	/customField.create	conn_mod_def::GMPpXU-agaY::7v-HMWgPQU2CCoQraBlrsQ
Get Information About a Custom Field	POST	/customField.info	conn_mod_def::GMPpXUsxOME::moI65wWFSIm45mv4iMF9gQ
Set Value Using Custom Field	POST	/customField.setValue	conn_mod_def::GMPpXbcmsKA::4_BBNZPkRwSb7pSxLPqkjA
Update Selectable Values for a Custom Field	POST	/customField.updateSelectableValues	conn_mod_def::GMPpXbiOAFM::uRAeX78eTteoK0T6lE_LbA

Users

Action	Method	Path	Action id
List Users	POST	/user.list	conn_mod_def::GMPpagXmRtQ::v379TzLyS1mdriXFNcQLwQ
Search Users by Email	POST	/user.search	conn_mod_def::GMPpag2HhhU::SN62J_juTFOHL0i4EqeZGA
Set Custom Field Value Using User	POST	/user.setCustomFieldValue	conn_mod_def::GMPpamwDxP4::xkVcDrWlQnWDyHFXs4Hm1g
Set Custom Field Values for a User	POST	/user.setCustomFieldValues	conn_mod_def::GMPpaoKeLqk::qX5Q34cnTNepu-Q_5bW-ow

Assessment

Action	Method	Path	Action id
Cancel an Assessment	POST	/assessment.cancel	conn_mod_def::GMPpWi_kb0c::OuW7ssM_SgiXwY1WFj7c3Q
Start an Assessment	POST	/assessment.start	conn_mod_def::GMPpWjNUk04::CMiN4D_gTQaF-Z9PCmYRNQ
Update Assessment	POST	/assessment.update	conn_mod_def::GMPpWibinwQ::lsvKAqGxQj2OpwIfEVtXPw

Candidate

Action	Method	Path	Action id
Anonymize a Candidate	POST	/candidate.anonymize	conn_mod_def::GMPpWz9tyHE::kdA52w8PTh2dAqY9avCoSw
Push a Candidate to an HRIS	POST	/candidate.pushToHris	conn_mod_def::GMPpW6ND-i8::BY8N3_geQrO7RFKL0Bwk7A
Remove a Project from a Candidate	POST	/candidate.removeProject	conn_mod_def::GMPpXEUVKeg::GdDXCzEJR_i46fOg1EiBZQ

InterviewSchedule

Action	Method	Path	Action id
Cancel an Interview Schedule	POST	/interviewSchedule.cancel	conn_mod_def::GMPpX_1bn68::jvrGpeG7TB24h8Up14TC3Q
Create an Interview Schedule	POST	/interviewSchedule.create	conn_mod_def::GMPpX_dKWqg::0tHdRH-jRJm89YUyqNLL1w

1 more InterviewSchedule actions are available through search.

This lists 90 of 177 actions. For anything not here, call search_one_platform_actions with platform ashby. The full catalog is at https://www.withone.ai/knowledge/ashby.

When a call fails

The error comes from Ashby, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/ashby

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.