Ashby
Manage recruiting jobs, candidates, applications, and interview schedules
Connect Ashby when a project needs live recruiting data or must create and update hiring records. Ashby uses a workspace API key, so an administrator controls whether the connector is visible and each workspace supplies its own key. No Swarmz OAuth application is required.
Before you connect
Create an API key in Ashby and grant only the modules your workflow needs. Ashby API-key permissions can restrict access by module; a key that can read candidates may still be unable to read jobs or create applications. Enter the key in the secure connector form, never in chat or project source.
Swarmz sends requests only to Ashby's fixed HTTPS API origin with the required API version header. See Ashby's authentication reference for key creation and permission details.
Available operations
| Operation | What it does | Limit per minute |
|---|---|---|
list_jobs | Lists jobs with status, date, expansion, and incremental-sync filters | 30 |
get_job | Reads one job | 30 |
create_job | Creates one job | 10 |
update_job | Updates one job | 10 |
set_job_status | Sets a job to draft, open, closed, or archived | 10 |
list_candidates | Lists candidates with pagination or incremental sync | 30 |
search_candidates | Finds candidates by email or name | 30 |
get_candidate | Reads one candidate | 30 |
create_candidate | Creates one candidate | 10 |
update_candidate | Updates one candidate | 10 |
list_applications | Lists applications by job, status, date, or sync token | 30 |
get_application | Reads one application | 30 |
create_application | Applies an existing candidate to a job | 10 |
list_interview_schedules | Lists interview schedules for an application or stage | 30 |
Write operations pause for AI approval during a build. Swarmz validates identifiers, accepted fields, page limits, and response size before sending or returning data.
Connect Ashby
Ask the AI for the recruiting workflow and name the records it should use. For example: “Use our shared Ashby connection to list open engineering jobs and show active applications for the selected job.” To change provider data, be explicit: “Create a candidate from this form, then create an application for the selected job.”
In Settings > Integrations, select Ashby, select Connect new, and enter the API key in the secure credential form. Link the connection to the project when prompted.
Verify Ashby
- List jobs and confirm a known open job in Ashby.
- Search for a test candidate and read the candidate record.
- Create a disposable candidate, then update its name or source.
- Create an application for a test job and confirm it in Ashby.
- List interview schedules for the application.
If one module returns a permission error while another works, update the API key permissions in Ashby or create a narrower key with the required module. Rotate a leaked key in Ashby, then replace it in the Swarmz connection.