JobAdder API

Name: JobAdder API
Brand: JobAdder API
Availability: InStock

✓ Official Vendor SpecHR recruitingRecruiting Atsoauth219 EndpointsREST

For Agents

Drive a JobAdder ATS: list and post jobs, search and submit candidates, schedule interviews, log placements, and read company and contact records.

Install Jentic One Beta

Connect the JobAdder API to your agent

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.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# 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 instance

Jentic 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.

Capabilities

What an agent can do with JobAdder 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

GET STARTED

Start building with JobAdder API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use JobAdder 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.

Key Endpoints

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

GET

/jobs

List jobs

GET

/jobs/{jobId}

Read a single job

GET

/candidates

Search candidates

GET

/candidates/{candidateId}

Read a single candidate

GET

/placements

List placements

GET

/companies

List client companies

GET

/jobs

List jobs

GET

/jobs/{jobId}

Read a single job

GET

/candidates

Search candidates

GET

/candidates/{candidateId}

Read a single candidate

GET

/placements

List placements

GET

/companies

List client companies

Why Jentic?

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.

FAQs

Specific to using JobAdder 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.