JobAdder

The Autohive JobAdder integration connects your JobAdder recruitment account to Autohive. It covers the core hiring flow plus client data and reporting. Your agent can find jobs, candidates, contacts, and companies. It can read notes and activity history. It can manage candidate and job documents, add candidates to jobs, and report on placements. It can also update candidate and contact profiles and change their statuses.

• Find jobs and candidates. Search and filter jobs, candidates, applications, and placements.
• Create candidates. Add new candidates with contact, employment, and skill details.
• Update candidates and contacts. Change profile fields and move records to a new status.
• Add candidates to jobs. Link existing candidates to a job to create applications.
• Manage candidate and job documents. Download, upload, and update resumes, job descriptions, and other files.
• Read client data. Look up contacts, companies, and their notes and activity history.
• Report on placements. Look up placement records, their approval status, and timesheets.

Install the integration link

1. Log in to Autohive and go to Your user profile > Connections, or Your workspace -> Integrations.

2. Find the JobAdder Integration card and click Connect to workspace.

   

3. Authorize with JobAdder. You’ll be redirected to JobAdder’s sign-in and approval page.

4. Approve the permissions. Autohive asks for read access to your JobAdder data. This covers your user profile, jobs, candidates, contacts, companies, applications, placements, notes, activities, attachments, timesheets, and availability. It also asks for write access to create and update candidates and contacts, and to create applications. Write access also lets Autohive upload and update candidate and job documents. Offline access keeps your connection active.

5. Confirm installation. You’ll return to Autohive with “Connected” status.

Use the integration link

Turn on JobAdder capabilities in Agent settings → Add capabilities. A capability is one action your agent can take.

1. Follow our Create your first agent guide to build an agent.
2. Turn on the capabilities you want your agent to use.
3. Start prompting your agent with the task you want to do with JobAdder.

Available capabilities link

Account link

• Get Current User — Return the JobAdder user linked to this connection.

Jobs link

• List Jobs — Search jobs by title, company, status, and more.
  • Filters: title, company, status, owner, active state, created or updated date.
  • Supports offset and limit paging.
• Get Job — Get one job’s full details by its ID.
• List Job Applications — List all or only active applications for a job.
• List Job Placements — List all or only approved placements for a job.
• List Job Attachments — List the files attached to a job.
  • Filters: native document type (Other or Job Description), latest version only.
  • Supports offset and limit paging.
• List Job Attachment Categories — List the custom job document categories your JobAdder account uses.
  • Can be limited to one native document type.
• Download Job Attachment — Download one job document, up to 5 MB.
  • Returns the file name, file type, and content.
  • Can ask JobAdder to convert supported files to another format.
• Upload Job Attachment — Upload a document to a job, up to 5 MB.
  • Works with a file shared in your agent chat.
  • Uses the native type Other or Job Description.
• Update Job Attachment — Change a job document’s type, category, or expiry date.
  • Send at least one of type, category, or expiry.
  • Send null for category or expiry to clear it.
  • For a custom category, upload the file first. Then update it using the returned ID.
• List Job Notes — List a job’s full-text notes.
  • Filters: note type, reference, created or updated date.
• List Job Activities — List a job’s activity history.
• List Job Note Types — List the note types your JobAdder account uses for jobs.

Candidates link

• List Candidates — Search candidates by name, email, phone, or resume keywords.
  • Filters: status, recruiter, created or updated date.
• Get Candidate — Get one candidate’s full profile by ID.
• Create Candidate — Add a new candidate to JobAdder.
  • Supports contact details, employment history, skills, education, and social links.
  • JobAdder does not require a first or last name.
  • Pass a duplicate override code to confirm an intentional duplicate.
• Update Candidate — Change fields on an existing candidate.
  • Only the fields you send change. Other fields stay as they are.
  • Send null (an empty value) to clear a field that JobAdder lets you empty.
  • Send at least one field besides the candidate ID.
  • Fields: name, email, phone, mobile, salutation, status, rating, seeking, address, social links.
  • More fields: skill tags, custom skills, employment, availability, education, custom fields, recruiters, summary, unsubscribed.
  • Pass a duplicate override code to confirm an intentional duplicate.
• List Candidate Statuses — List the candidate statuses your JobAdder account uses.
  • Filters: status IDs, name, active state, default status.
  • Use it to find a status ID before you change a status.
• Set Candidate Status — Move a candidate to a new status.
  • Needs the candidate ID and a status ID from List Candidate Statuses.
  • Can record a note type and note text with the change.
• List Candidate Applications — List all or only active applications for a candidate.
• List Candidate Placements — List all or only approved placements for a candidate.
• List Candidate Skills — List a candidate’s skill categories.
• Get Candidate Availability — Get a candidate’s availability details.
• List Candidate Notes — List a candidate’s full-text notes.
  • Filters: note type, reference, created or updated date.
• List Candidate Note Types — List the note types your JobAdder account uses for candidates.
• List Candidate Attachments — List a candidate’s documents.
  • Filters: native document type, tenant category, latest version only.
• List Candidate Attachment Categories — List the custom document categories your JobAdder account uses, such as Work Rights.
• Download Candidate Attachment — Download one candidate document, up to 5 MB.
• Upload Candidate Attachment — Upload a document to a candidate, up to 5 MB.
  • Uses a native JobAdder type such as Resume, Cover Letter, or Reference.
• Update Candidate Attachment — Change a document’s type, category, or expiry date.

Contacts and companies link

• List Contacts — Search contacts by company, name, email, phone, or hiring-manager status.
  • Filters: creator or consultant, status, created or updated date.
• Get Contact — Get one contact’s full details by ID.
• Update Contact — Change fields on an existing contact.
  • Only the fields you send change. Send null to clear a field that JobAdder lets you empty.
  • Send at least one field besides the contact ID.
  • Fields: company, name, email, phone, mobile, salutation, position, status, owner, recruiters.
  • More fields: manager contact, office address, other emails, social links, summary, unsubscribed, custom fields.
  • Pass a duplicate override code to confirm an intentional duplicate.
• List Contact Statuses — List the contact statuses your JobAdder account uses.
  • Filters: status IDs, name, active state, default status.
  • Use it to find a status ID before you change a status.
• Set Contact Status — Move a contact to a new status.
  • Needs the contact ID and a status ID from List Contact Statuses.
  • Can record a note type and note text with the change.
• List Contact Jobs — List the jobs linked to a contact.
• List Contact Notes — List a contact’s full-text notes.
  • Filters: note type, reference, created or updated date.
• List Contact Activities — Search a contact’s activity history.
  • Filters: activity type, created or updated date.
• List All Contact Activities — Build an activity report for up to 100 contacts over a date range.
  • Useful for a monthly or quarterly client activity report.
• Get Note — Get one complete note or activity record by its ID.
• List Contact Note Types — List the note types your JobAdder account uses for contacts.
• List Companies — Search companies by name, status, or audit date.
  • Filters: creator or consultant, created or updated date.
• Get Company — Get one company’s full details by ID.
• List Company Contacts — List the people linked to a company.
• List Company Addresses — List a company’s office locations.
• List Company Jobs — List all or only active jobs for a company.
• List Company Placements — List all or only approved placements for a company.
• List Company Attachments — List the files attached to a company.
• List Company Notes — List a company’s full-text notes.
  • Filters: note type, reference, created or updated date.
• List Company Note Types — List the note types your JobAdder account uses for companies.

Applications link

• List Applications — Search applications by candidate, job, or status.
  • Filters: activity, rejection, resume keywords, created or updated date.
• Get Application — Get one application’s full details by ID.
• Add Candidates to Job — Link one or more existing candidates to a job.
  • Creates a new application for each candidate added.
• List Application Attachments — List the files attached to an application.
• List Application Notes — List an application’s full-text notes.
• List Application Activities — List an application’s activity history.

Placements link

• List Placements — Search placements by candidate, job, company, or status.
  • Filters: approval state, created or updated date.
• Get Placement — Get one placement’s full details by ID.
• List Placement Attachments — List the files attached to a placement.
• List Placement Notes — List a placement’s full-text notes.
• List Placement Activities — List a placement’s activity history.
• List Placement Note Types — List the note types your JobAdder account uses for placements.
• List Placement Timesheets — List a placement’s timesheets.
  • Can be limited to a date range.

Key features link

Pagination and date filters link

List actions return up to 100 results by default. Set a higher limit, up to 1,000, to get more in one call. Set the limit to 0 to get only the total count.

Date filters use the ISO 8601 format. Add a > or < before a date to match records after or before it. For example, >2026-01-01T00:00:00Z matches records updated after 1 January.

Consistent response shape link

List actions return the matching records, a total count, and JobAdder’s pagination links. Get and create actions return the full JobAdder record, including any custom fields.

Full-text notes and activity reporting link

Notes and activities carry their full text, type, dates, and the consultant who created them. The list_all_contact_activities action builds one report across up to 100 contacts. You can summarize client engagement without looping through contacts one at a time.

Candidate and job documents link

Candidates and jobs share the same document actions. You can list, download, upload, and update files on both. Each file is up to 5 MB. Files move in and out as Autohive file objects, so your agent can use a document shared in chat.

JobAdder splits documents two ways. The native type is built in, such as Resume or Job Description. The category is a custom label set up in your account. Upload a file with a native type first. Then set a custom category with the update action.

Partial updates and statuses link

The update actions for candidates and contacts change only the fields you send. Leave a field out to keep it as it is. Status IDs differ between JobAdder accounts. List the statuses first, then use the ID you need.

Least-privilege access link

The integration only asks for the access it needs. It can read users, jobs, candidates, contacts, companies, notes, activities, attachments, applications, placements, timesheets, and availability. It can create and update candidates and contacts, and create applications. It can upload and update candidate and job documents. It stays connected using offline access.

Common use cases link

Candidate sourcing link

• Search for candidates by name, email, phone, or a resume keyword like a specific skill.
• Create a candidate record from a resume or referral.
• Add a shortlisted candidate straight to an open job.
• Download a candidate’s resume before scheduling an interview.

Keeping records current link

• Update a candidate’s phone number or email after a call.
• Move a candidate to a new status and record why.
• Change a contact’s status after a client meeting.
• Add skill tags to a candidate after you read their resume.

Job documents link

• Download a job description to draft an advert or a candidate brief.
• Upload a job description to the job record.
• Sort job documents into your custom categories.

Recruitment reporting link

• Pull a list of active jobs and their status for a weekly report.
• Check placement approval status before running payroll or invoicing.
• Track new applications against a job over time.
• Build a monthly client activity report across a list of contacts.

Candidate and application lookups link

• Look up a candidate’s full profile before an interview.
• Check an application’s status when a candidate asks for an update.
• Review a contact’s note history before a client call.

Notes link

• Some records can be changed. You can create and update candidates, update contacts, and change candidate and contact statuses. You can also upload and update candidate and job documents. Companies, notes, activities, and application and placement attachments are read-only.
• File types are limited. JobAdder restricts attachment file extensions. It returns an error for files it does not accept.
• API access needs approval. JobAdder controls API access. It may ask for partner or developer approval.
• Rate limits apply per JobAdder account. Avoid frequent polling in your workflows.
• No delete support for created records. JobAdder has no matching delete operation for candidates, applications, or documents made through this integration.
• Some things are out of scope. The integration does not manage job records, application statuses, requisitions, job ads, or partner actions. It does not manage webhooks either. A webhook is an automatic message sent when something changes.

Disconnect the integration link

Important: Disconnecting removes Autohive’s access to your JobAdder account.

1. Go to Your user profile -> Connections, or Your workspace -> Integrations.
2. Find the JobAdder Integration.
3. Click Disconnect and confirm.

Data Impact: Disconnecting stops access with your stored credentials. It does not change any data in your JobAdder account.