Back to Help Centre
Integrations

Connecting JobAdder

How to connect your JobAdder account, sync data, map statuses, and manage the integration.

ScoutUp integrates with JobAdder to automatically sync your jobs, candidates, and applications. Once connected, data flows both ways — applications come in from JobAdder, and evaluation results are exported back.

Connecting your account

  1. Navigate to Settings from the sidebar
  2. Click JobAdder in the integrations section
  3. Click Connect JobAdder
  4. You'll be redirected to JobAdder's login page. Sign in with your JobAdder credentials
  5. Review the permissions ScoutUp is requesting and click Authorise
  6. You'll be redirected back to ScoutUp with a "Connected" status

During connection, ScoutUp automatically sets up:

  • A "Manage Job in ScoutUp.ai" button that appears on jobs inside JobAdder
  • Webhooks to receive real-time updates when application statuses change or candidates are updated in JobAdder

What gets synced

The integration has three independent sync types, each with its own toggle:

Job sync

When enabled, ScoutUp imports jobs from JobAdder including the title, description, company, and status. JobAdder job statuses are mapped to ScoutUp statuses:

  • Open, active, and published jobs become Active in ScoutUp
  • Closed, filled, archived, expired, draft, and inactive jobs become Inactive

Candidate sync

When enabled, ScoutUp imports candidate records from JobAdder including name, email, phone number, job title, LinkedIn URL, location, skills, and tags. Candidates are matched by their JobAdder ID first, then by email address to avoid duplicates.

Application sync

When enabled, ScoutUp imports job applications from JobAdder and links them to the synced jobs and candidates. Application statuses from JobAdder are mapped to ScoutUp statuses using the status mapping you configure (see below).

Application sync requires both job sync and candidate sync to be enabled, since applications need existing job and candidate records to link to.

Sync frequency

Automatic sync runs every hour in the background. Each sync is incremental — only records that have changed since the last sync are fetched. The first sync fetches records from the last 30 days.

Additionally, real-time webhooks notify ScoutUp immediately when:

  • An application status changes in JobAdder
  • A candidate is updated in JobAdder

Status mapping

JobAdder and ScoutUp use different application statuses. To keep them in sync, you need to map JobAdder statuses to your ScoutUp statuses:

  1. On the JobAdder integration page, scroll to the Status Mapping section
  2. You'll see a list of all available JobAdder statuses
  3. For each JobAdder status, select the corresponding ScoutUp status from the dropdown
  4. Click Save Mappings

When an application's status changes in JobAdder, ScoutUp uses this mapping to update the local status. If a JobAdder status doesn't have a mapping, the raw status name is still stored but the ScoutUp status won't be updated.

Triggering a full sync

By default, syncs are incremental. If you need to backfill historical data or re-sync everything, use the Trigger Full Sync button available for each sync type (jobs, candidates, applications).

A full sync fetches all records from JobAdder, not just recent changes. This is useful when:

  • You've just connected and want to import your entire candidate database
  • You suspect some records were missed during incremental sync
  • You've made bulk changes in JobAdder that need to be reflected in ScoutUp

Full syncs may take longer depending on how much data is in your JobAdder account. A progress indicator shows while the sync is running.

The "Manage in ScoutUp" button

After connecting, a "Manage Job in ScoutUp.ai" button appears on job pages inside JobAdder. Clicking it:

  1. Opens ScoutUp in a new tab
  2. If the job doesn't exist in ScoutUp yet, it's imported automatically along with its applications
  3. You're taken to the job page in ScoutUp where you can set up interviews, configure evaluation, and start screening candidates

This is a quick way to bring individual jobs into ScoutUp from your day-to-day JobAdder workflow without needing a full sync.

Document import

ScoutUp automatically imports candidate attachments from JobAdder, including resumes, certificates, and other documents. Attachments are:

  • Polled every hour for new uploads
  • Downloaded and stored as application documents in ScoutUp
  • Available for document evaluation against your configured criteria

Duplicate documents are detected and skipped to avoid importing the same file twice.

Evaluation export

When ScoutUp completes an evaluation (either interview or document), the results are automatically exported back to JobAdder as a note on the application. The note includes:

  • The evaluation type (interview or document)
  • The score and pass/fail result
  • A summary of the evaluation
  • A link back to the full evaluation in ScoutUp

This means your team can see evaluation results directly in JobAdder without switching tools.

Disconnecting

To disconnect JobAdder, click Disconnect on the integration page. This will:

  • Remove the "Manage in ScoutUp" button from JobAdder
  • Delete the webhooks so real-time updates stop
  • Remove the stored connection credentials

Existing jobs, candidates, and applications that were already synced will remain in ScoutUp — only the live connection is removed.

Troubleshooting

  • Sync seems slow or stuck — JobAdder enforces rate limits on API requests. If ScoutUp hits the limit, syncing pauses temporarily and resumes automatically. Large full syncs may take a few sync cycles to complete
  • Missing applications — make sure both job sync and candidate sync are enabled. Applications can only be linked if the job and candidate already exist in ScoutUp
  • Status not updating — check your status mapping. If a JobAdder status doesn't have a mapping configured, the ScoutUp application status won't change
  • Documents not appearing — document polling runs hourly. New documents may take up to an hour to appear after being uploaded to JobAdder