For Agents
Drive a JobAdder ATS: list and post jobs, search and submit candidates, schedule interviews, log placements, and read company and contact records.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the JobAdder API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with JobAdder API API.
List and post job openings via /jobs and /jobs/{jobId}
Search candidates and read full candidate profiles through /candidates
Submit candidates to jobs and progress them through stages with /applications
Schedule and read interview events via /interviews
GET STARTED
Use for: Search JobAdder for candidates matching a Python developer role, Post a new job opening to JobAdder, Submit a candidate for a specific job in JobAdder, Schedule an interview between a candidate and a hiring manager
Not supported: Does not run payroll, post to job boards directly, or perform candidate sourcing — use for ATS pipeline operations on JobAdder records only.
The JobAdder API is the integration surface for JobAdder's applicant tracking system (ATS), used by recruitment agencies and in-house talent teams. Its 19 endpoints cover the core recruiting workflow: jobs, candidates, applications, interviews, placements, companies, contacts, and notes. Authentication is OAuth 2.0 against the JobAdder identity service, and resources scope automatically to the authenticated account. The spec mirrors JobAdder's published v2 production API.
Record placements (hires) for billing and pipeline reporting via /placements
Manage client companies and contact records through /companies and /contacts
Attach notes to jobs, candidates, or companies for audit trail via /notes
Patterns agents use JobAdder API API for, with concrete tasks.
★ Sourcing-Tool to ATS Sync
Recruiters source candidates from LinkedIn, job boards, and outbound campaigns then need them inside JobAdder to track them against jobs. An automation creates the matching JobAdder candidate via POST /candidates and submits them to the right job via /applications, eliminating manual rekeying for agencies that touch hundreds of candidates per week.
POST /candidates with the sourced candidate's name, email, and CV URL, then POST /applications linking the new candidateId to the target jobId at submitted stage.
Job Distribution to Job Boards
When a recruiter posts a new role in JobAdder, an integration listens for the new /jobs record and pushes it to LinkedIn, Indeed, and Adzuna. The reverse direction — applications received on those boards — flows back into /applications so recruiters work in JobAdder while jobs reach a wider audience.
GET /jobs filtered to status=open and posted within the last 24 hours, then for each job push a normalised payload to the configured downstream job board.
Placement Reporting and Billing
Recruitment agencies bill clients on placement (start) and need a real-time view of placements per consultant per month. An automation pulls /placements weekly, joins the consultant and company references, and writes a placement-by-consultant report to a finance system without touching the JobAdder UI.
GET /placements with createdFrom={start_of_month} and groupBy=consultant, then write the totals to the finance system for commission calculation.
AI Agent Integration via Jentic
A recruiting copilot uses Jentic to discover JobAdder operations by intent. The agent searches for 'submit a candidate to a job' and Jentic returns the /applications operation with its required candidateId, jobId, and stage parameters, so the agent makes the right call without scraping vendor docs. The OAuth token stays in the Jentic vault.
Search Jentic for 'submit a candidate to a job', load the POST /applications schema, and execute it for the chosen candidate and job.
19 endpoints — the jobadder api is the integration surface for jobadder's applicant tracking system (ats), used by recruitment agencies and in-house talent teams.
METHOD
PATH
DESCRIPTION
/jobs
List jobs
/jobs/{jobId}
Read a single job
/candidates
Search candidates
/candidates/{candidateId}
Read a single candidate
/placements
List placements
/companies
List client companies
/jobs
List jobs
/jobs/{jobId}
Read a single job
/candidates
Search candidates
/candidates/{candidateId}
Read a single candidate
/placements
List placements
/companies
List client companies
Three things that make agents converge on Jentic-routed access.
Credential isolation
JobAdder OAuth access tokens are stored encrypted in the Jentic vault and injected at execution time. Raw tokens never enter the agent's prompt context.
Intent-based discovery
Agents search Jentic with intents like 'submit a candidate to a job' and Jentic returns the JobAdder /applications operation with its parameter schema.
Time to first call
Direct JobAdder integration: 2-5 days for OAuth, pagination, and pipeline-stage modelling. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Greenhouse API
Greenhouse is an alternative ATS aimed at in-house talent teams with deeper structured-interview tooling
Pick Greenhouse when the buyer is an in-house team running structured hiring loops; pick JobAdder for recruitment-agency placement-and-billing workflows.
Lever API
Lever is an in-house ATS with strong CRM-style sourcing pipeline support
Pick Lever for sourcing-led in-house teams; pick JobAdder for high-volume agency recruiting with placement billing.
Adzuna API
Source job-market data and post jobs to Adzuna alongside running JobAdder as the ATS
Use Adzuna alongside JobAdder when an agent needs job-board reach and salary benchmark data while JobAdder remains the system of record.
Specific to using JobAdder API API through Jentic.
What authentication does the JobAdder API use?
OAuth 2.0 against id.jobadder.com. Apps obtain client credentials in the JobAdder partner portal, complete the authorization-code flow per JobAdder account, and send the access token as Authorization: Bearer <token>. Through Jentic the OAuth flow is brokered and tokens are kept in the vault.
Can I submit a candidate to a specific job with the JobAdder API?
Yes. POST /applications with candidateId, jobId, and the desired stage. JobAdder creates the application and progresses it as you POST further updates with new stages or PATCH it as the candidate moves through the pipeline.
What are the rate limits for the JobAdder API?
JobAdder applies per-account rate limits (the spec does not pin a fixed number; the developer portal documents the current values). Treat 429 responses as the trigger to back off; for large candidate or jobs syncs, paginate through resources rather than fetching everything at once.
How do I post a new job through Jentic?
Run pip install jentic, search for 'post a new job to jobadder', then load and execute POST /jobs with the title, company reference, and description. Jentic injects the OAuth token automatically.
Can I read placements for billing reporting with the JobAdder API?
Yes. GET /placements returns each placement with the candidate, job, company, consultant, and start date references needed to calculate commissions or send invoices. Filter by date range to scope to a billing period.
Is the JobAdder API free?
API access is included with paid JobAdder accounts. Partner integrations may have additional review or commercial steps documented in the JobAdder partner portal.