AshbyApi

Arcade Starter

Description: Tools that enable LLMs to interact directly with the Ashby API

Author: Arcade

Auth: API Key

AshbyApi is a Starter MCP Server: each tool mirrors one HTTP endpoint and offers LLMs a way to interact with the low-level API.

Differently from Optimized MCP Servers, Starter tools are heavily influenced by the original API design, which is not usually optimized for LLM usage. For this reason, we recommend thoroughly evaluating the tools with your Agents or chatbots before using it in production. Read more about Optimized vs Starter tools.

The AshbyApi MCP Server offers a comprehensive suite of tools for managing recruitment processes within the Ashby platform. Users can perform a variety of actions, including:

Create, update, and manage job applications and candidates.
Retrieve detailed information about candidates, applications, jobs, and departments.
Manage interview schedules, feedback, and assessments.
Handle job postings, openings, and associated locations.
Utilize webhooks for event notifications and manage user permissions.

This server is designed to streamline the hiring process, making it easier to track candidates and manage recruitment workflows effectively.

Available Tools

Tool Name	Description
AshbyApi.GetApiKeyInfo	Retrieve information about the current API key in use.
AshbyApi.ChangeApplicationSource	Change the source of an application in Ashby.
AshbyApi.ChangeApplicationStage	Change the stage of a candidate's application.
AshbyApi.CreateJobApplication	Create a job application for a candidate.
AshbyApi.FetchApplicationDetails	Fetch application details using application or form instance ID.
AshbyApi.ListApplications	Retrieve all applications in the organization.
AshbyApi.TransferApplicationToJob	Transfer an application to a different job.
AshbyApi.UpdateApplicationStatus	Updates the status or details of an application.
AshbyApi.UpdateApplicationHistory	Update the history of an application.
AshbyApi.GetApplicationHistory	Fetch a paginated list of application history items.
AshbyApi.GetCandidateCriteriaEvaluations	Retrieve AI evaluations for candidate job criteria.
AshbyApi.ListApplicationFeedback	Retrieve interview feedback and scorecards for applications.
AshbyApi.AddHiringTeamMember	Add a user to the hiring team for an application.
AshbyApi.RemoveHiringTeamMember	Remove a user from the hiring team for an application.
AshbyApi.GetHiringTeamRoles	Retrieve all available hiring team roles for applications.
AshbyApi.SubmitApplicationFeedback	Submit application feedback forms with various field types.
AshbyApi.GetApprovalList	Retrieve all approvals in the organization.
AshbyApi.UpdateApprovalDefinition	Create or update an approval definition for an entity.
AshbyApi.ListArchiveReasons	Retrieve a list of archive reasons.
AshbyApi.AddCompletedAssessmentToCandidate	Adds a completed assessment to a candidate's record.
AshbyApi.StartAssessment	Start an assessment using the Ashby API.
AshbyApi.ListAssessments	Retrieve a list of available assessments.
AshbyApi.UpdateAssessmentStatus	Update the status of a candidate assessment in Ashby.
AshbyApi.CancelAssessment	Cancel an ongoing assessment.
AshbyApi.AddCandidateToProject	Add a candidate to a specified project.
AshbyApi.AddCandidateTag	Add a tag to a candidate in the recruitment system.
AshbyApi.AnonymizeCandidateData	Permanently anonymize a candidate's data in the system.
AshbyApi.CreateCandidate	Create a new candidate entry.
AshbyApi.CreateCandidateNote	Add a note to a candidate's profile in Ashby.
AshbyApi.GetCandidateInformation	Retrieve detailed information of a candidate using their ID.
AshbyApi.ListCandidates	Retrieve a list of all candidates in an organization.
AshbyApi.ListCandidateClientInfo	Retrieve client info records for a candidate.
AshbyApi.ListCandidateNotes	Retrieve all notes associated with a candidate.
AshbyApi.ListCandidateProjects	Retrieve all projects linked to a candidate.
AshbyApi.FindCandidates	Search for candidates by email or name.
AshbyApi.UpdateCandidateInfo	Update an existing candidate's information.
AshbyApi.CreateCandidateTag	Create a new candidate tag in the Ashby system.
AshbyApi.ListCandidateTags	Retrieve a list of all candidate tags.
AshbyApi.ListCloseReasons	Get a list of close reasons for jobs or openings.
AshbyApi.ListEnabledCommunicationTemplates	Retrieve all enabled communication templates.
AshbyApi.CreateCustomField	Creates a new custom field in Ashby.
AshbyApi.GetCustomFieldInfo	Retrieve information about a custom field.
AshbyApi.ListCustomFields	Retrieve a list of all custom fields.
AshbyApi.SetCustomFieldValue	Update the value of a custom field for an object.
AshbyApi.CreateDepartment	Create a new department within an organization.
AshbyApi.ArchiveDepartment	Archive a department within an organization.
AshbyApi.RestoreDepartment	Restores a previously deleted department.
AshbyApi.GetDepartmentDetails	Fetches department details using a department ID.
AshbyApi.ListDepartments	Retrieve a list of all departments.
AshbyApi.MoveDepartment	Relocate a department to a new parent structure.
AshbyApi.UpdateDepartment	Update existing department details in the system.
AshbyApi.RetrieveCandidateFileUrl	Retrieve the URL of a candidate's associated file.
AshbyApi.GetFeedbackFormInfo	Fetch detailed information about a specific feedback form by ID.
AshbyApi.ListFeedbackForms	Retrieve a list of all feedback forms.
AshbyApi.HiringTeamAddMember	Adds a user to the hiring team for a job or application.
AshbyApi.RemoveTeamMemberFromHiring	Remove a member from the hiring team at job or application level.
AshbyApi.ListHiringTeamRoles	Retrieve possible hiring team roles within an organization.
AshbyApi.FetchInterviewDetails	Retrieve interview details using interview ID.
AshbyApi.ListInterviews	Retrieve a list of all scheduled interviews.
AshbyApi.ListInterviewEvents	Retrieve a list of interview events for a schedule.
AshbyApi.ListInterviewPlans	Fetch a list of all available interview plans.
AshbyApi.CancelInterviewSchedule	Cancel an interview schedule using its ID.
AshbyApi.CreateInterviewSchedule	Create a scheduled interview in Ashby.
AshbyApi.GetInterviewSchedules	Retrieve all interview schedules for the organization.
AshbyApi.UpdateInterviewSchedule	Update, add, or cancel interview schedule events.
AshbyApi.ListInterviewStages	Retrieve all interview stages for an interview plan in order.
AshbyApi.FetchInterviewStageDetails	Fetches details of a specific interview stage.
AshbyApi.ListInterviewStageGroups	Retrieve all interview group stages in order.
AshbyApi.ListInterviewerPools	Fetches a list of all interviewer pools.
AshbyApi.GetInterviewerPoolInfo	Retrieve information about an interviewer pool.
AshbyApi.CreateInterviewerPool	Creates a new interviewer pool for hiring processes.
AshbyApi.UpdateInterviewerPool	Update an interviewer pool.
AshbyApi.ArchiveInterviewerPool	Archive an interviewer pool when needed.
AshbyApi.RestoreInterviewerPool	Restores an archived interviewer pool.
AshbyApi.AddUserToInterviewerPool	Add a user to an interviewer pool in Ashby.
AshbyApi.RemoveUserFromInterviewerPool	Remove a user from an interviewer pool.
AshbyApi.CreateNewJob	Create a new job listing with specified details.
AshbyApi.GetJobDetails	Retrieve detailed information about a job using its ID.
AshbyApi.ListAllJobs	Retrieve all open, closed, and archived jobs from Ashby.
AshbyApi.SetJobStatus	Update the status of a job by its ID.
AshbyApi.UpdateJobDetails	Update details of an existing job.
AshbyApi.UpdateJobCompensation	Update a job's compensation details.
AshbyApi.SearchJobsByTitle	Search for jobs by title.
AshbyApi.ListEnabledJobBoards	Retrieve all enabled job boards.
AshbyApi.JobInterviewPlanInfo	Retrieve a job's interview plan details.
AshbyApi.GetJobPostingInfo	Retrieve detailed information about a specific job posting.
AshbyApi.ListPublishedJobPostings	Retrieve all published and publicly listed job postings.
AshbyApi.ListJobTemplates	Retrieve all active and inactive job templates.
AshbyApi.UpdateJobPosting	Update an existing job posting on the Ashby platform.
AshbyApi.ArchiveLocation	Archives a location or location hierarchy.
AshbyApi.CreateLocation	Create a location or location hierarchy.
AshbyApi.GetLocationDetails	Retrieve detailed information for a specific location.
AshbyApi.ListAllLocations	Retrieve a list of all available locations.
AshbyApi.MoveLocationInHierarchy	Move a location within the organizational hierarchy.
AshbyApi.RestoreArchivedLocation	Restores an archived location or hierarchy.
AshbyApi.UpdateLocationAddress	Update the address of a location.
AshbyApi.UpdateLocationName	Updates the name of a location.
AshbyApi.UpdateLocationRemoteStatus	Update the remote status of a specific location.
AshbyApi.UpdateWorkplaceType	Update the workplace type for a specific location.
AshbyApi.OfferApprovalAction	Approve an offer or a specific step in the approval process.
AshbyApi.CreateOffer	Create a new offer using specified form fields.
AshbyApi.GetOfferDetails	Retrieve details about a specific offer using its ID.
AshbyApi.GetLatestOffers	Retrieve the latest version of all offers available.
AshbyApi.CreateCandidateOfferVersion	Initiate a new offer version for a candidate.
AshbyApi.UpdateOffer	Update an existing offer and retrigger approval steps.
AshbyApi.StartOfferProcess	Initiate an offer process for a candidate.
AshbyApi.GetOpeningInfo	Retrieve job opening details using a UUID.
AshbyApi.ListJobOpenings	Retrieve a list of current job openings.
AshbyApi.SearchJobOpenings	Search for job openings by identifier.
AshbyApi.CreateJobOpening	Create a new job opening in the system.
AshbyApi.AddJobToOpening	Adds a job to an opening.
AshbyApi.RemoveJobFromOpening	Remove a job from an opening.
AshbyApi.AddLocationToJobOpening	Adds a location to a job opening.
AshbyApi.RemoveLocationFromOpening	Remove a location from a job opening.
AshbyApi.SetOpeningState	Update the state of a job opening.
AshbyApi.SetOpeningArchivedState	Set or unset the archived state of a job opening.
AshbyApi.UpdateJobOpening	Update the details of a job opening.
AshbyApi.GetProjectInformation	Retrieve detailed information about a project.
AshbyApi.ListProjects	Retrieve a list of projects.
AshbyApi.SearchProjectsByTitle	Search for projects by title for quick lookups.
AshbyApi.CreateCandidateReferral	Creates a candidate referral in the system.
AshbyApi.GetReferralFormInfo	Fetches or creates the default referral form details.
AshbyApi.GenerateAndPollReport	Generate a new report or poll status of report generation.
AshbyApi.RetrieveSyncReport	Retrieve report data synchronously with Ashby.
AshbyApi.ListAllSources	Retrieve a list of all sources for hiring processes.
AshbyApi.ListSourceTrackingLinks	Retrieve all source custom tracking links.
AshbyApi.GetSurveyFormDetails	Retrieve details of a survey form definition by id.
AshbyApi.ListSurveyFormDefinitions	Retrieve all survey form definitions.
AshbyApi.CreateSurveyRequest	Create a survey request and get a survey URL.
AshbyApi.ListSurveyRequests	Retrieve a list of all survey requests.
AshbyApi.CreateSurveySubmission	Create a new survey submission.
AshbyApi.ListSurveySubmissions	Retrieve all survey submissions for a specific type.
AshbyApi.GetAshbyUserInfo	Retrieve detailed information of a specific Ashby user.
AshbyApi.GetAshbyUserList	Retrieve a list of all users in Ashby and their access levels.
AshbyApi.AshbyUserSearch	Search for an Ashby user by email address.
AshbyApi.GetInterviewerSettings	Retrieve interviewer settings for a user.
AshbyApi.UpdateInterviewerSettings	Update interviewer settings for a user.
AshbyApi.CreateWebhookSetting	Creates a webhook setting in Ashby.
AshbyApi.RetrieveWebhookInfo	Retrieve detailed information on a specific webhook setting by ID.
AshbyApi.UpdateWebhookSetting	Update a webhook setting for Ashby service.
AshbyApi.DeleteWebhookSetting	Delete a webhook setting.

If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools.

AshbyApi.GetApiKeyInfo

Retrieve information about the current API key in use.

Parameters

empty_request_body (json, optional) Provide an empty JSON object as the request body. This is required to make the call but should contain no data.

Secrets