Skip to main content

JobAdder integration

Set up and manage the JobAdder integration with your Access Volcanic website to publish jobs and sync candidate applications.

Grace avatar
Written by Grace
Updated over 2 months ago

Overview

This article helps you understand and configure the JobAdder integration with Access Volcanic. The integration allows you to publish jobs from JobAdder to your website and manage candidate applications. You can set up location mapping for accurate job posting and troubleshoot common sync issues.


Key benefits

  • Publish jobs automatically from JobAdder to your Access Volcanic website through Application Programming Interface (API) connection.

  • Sync candidate applications and data between platforms, depending on your integration method.

  • Configure location hierarchies to ensure jobs appear in the correct geographical areas on your site.

  • Manage integration status and connectivity through your Admin Area.

  • Troubleshoot application and candidate sync issues quickly with clear diagnostic steps.

  • Choose between external application redirects or native website applications based on your workflow needs.


Before you start

Before configuring the JobAdder integration, make sure you have:

  1. Admin access to your Access Volcanic Admin Area.

  2. A JobAdder account with integration permissions.

  3. Knowledge of which integration method your organisation uses (external application link or app integration).

  4. A clear list of geographical locations where you post jobs.

πŸ“Œ Note: JobAdder uses a different location system than Access Volcanic. The SEO Locations feature in your Admin Area creates a mapping system for job placement.


Setting up the JobAdder integration

Before configuring locations or managing app connections, you need to set up the core integration components.

Setting up job posting from JobAdder

JobAdder can post jobs to your Access Volcanic website using a legacy token. This allows JobAdder to send job data directly to your site.

πŸ“Œ Note: Legacy token can be set up by any admin user, or with the help of our Professional Service team. See our Integrations guide to learn more.

Setting up sending candidate data to JobAdder

JobAdder can receive candidate data from your website in two main ways: via an external application URL being added to jobs or via an app integration.

External application URL method

JobAdder posts jobs to your website using external application URLs. When candidates click apply, they are redirected to JobAdder to complete their application.

  • How it works: JobAdder uses the external application URL field when posting jobs to Access Volcanic. Candidates complete applications directly in JobAdder's system.

  • Data behaviour: Your website records only the application click. JobAdder captures and stores all candidate data and applications.

πŸ“ŒNote: Ensure the Do not use job external application URLs option in Site Settings is disabled.

⚠️ Important: Website metrics show apply clicks, not completed applications when using this method.

App integration method

JobAdder posts jobs to your website through a dedicated app integration. Candidates apply directly through your website forms, and their completed applications are automatically sent to JobAdder.

  • How it works: A custom app is created to transfer candidate data from your Access Volcanic website to JobAdder's system in real-time.

  • Data behaviour: Candidate details and application data captured through your website are transferred to JobAdder automatically.

  • Cost implications: App creation requires setup by the Professional Services team and will be chargeable.

πŸ€“ Tip: Discuss integration options with your Account Manager or Customer Success Manager first. They can advise which method best suits your needs.


Setting up SEO Locations for JobAdder

JobAdder uses a different location system than Access Volcanic. You must configure a location hierarchy within your Admin Area to allow JobAdder jobs to map correctly to locations on your website.

Creating SEO Locations

SEO Locations are location-specific pages designed to boost local SEO and relevant traffic to your site and jobs.

You can create SEO Locations in the SEO Area in the admin area. See our SEO Tools guide to learn more.

πŸ“Œ Note: Not all website packages include SEO Locations. Contact your Account Manager to learn more.

πŸ€“ Tip: Build out your complete location structure before publishing jobs to ensure accurate mapping from the start.

Recommended location structure

We recommend creating SEO Locations following the 3 level hierarchy below.

πŸ€“ Tip: You can then change the hierarchy level using the drag-on-drop feature.

  1. Country: The top level (e.g., United Kingdom)

    1. County, area, or region: The middle level (e.g., Greater London)

      1. City or town: The bottom level (e.g., London)

You will end up having a location tree, with an SEO location for every Country, region, and town you post to. See the screenshot below as a visual aid.

Screenshot of Access Volcanic interface showing SEO location setup with a three-level hierarchy: Country, Region, and City.

Managing the JobAdder app integration

The JobAdder app connection can disconnect and interrupt processing of candidates and applications. Regular monitoring ensures smooth operation.

Checking integration status

  1. Log in to your admin area

  2. Select the Settings tab

  3. Under Site, click Apps.

  4. Select JobAdder to view the current status.

  5. Look for the status indicator:

    • Green tick (βœ“): Connected and working properly.

    • Red X (βœ—) β€” Disconnected and requires re-authorisation.

Re-authorising the JobAdder app

If the app shows as disconnected:

  1. Go to Settings, then click Apps.

  2. Select JobAdder.

  3. Click Authorise.

  4. Log in using your JobAdder credentials.

  5. Complete the authorisation process.

The status should update to show a green tick once the connection is restored.

πŸ“Œ Note: Some applications may be retriggered after re-authorising, depending on your setup configuration.


Best practices

Follow these guidelines to ensure your JobAdder integration works effectively:

Setup and maintenance

  • Review your SEO Location hierarchy regularly to ensure accurate mapping for new regions.

  • Re-authorise the JobAdder app immediately if you notice applications or candidates missing.

  • Monitor the app connection status regularly to catch disconnections early. early.

Documentation and team coordination

Regular maintenance tasks

Task

Frequency

Purpose

Document integration method

One-time setup

Avoid confusion during troubleshooting

Check app connection status

Weekly

Catch disconnections early

Review location mapping

Monthly

Ensure accuracy for new regions

  • Test location mapping with sample jobs before going live with new geographical areas.

  • Confirm your integration method with your team to avoid confusion during troubleshooting.


FAQs

Q1: How do I set up the JobAdder integration?

  • Answer: First set up a legacy token in your Admin Area for job posting. Then choose your candidate data method - external application URLs or app integration. Contact your Account Manager or Customer Success Manager to discuss which option suits your needs.

Q2: Can I set up the integration myself?

  • Answer: You can set up the legacy token for job posting yourself. For external application URLs, you need to check site settings. App integration requires Professional Services team setup and will be chargeable.

Q3: Which integration method should I choose?

  • Answer: External application URLs are potentially cost-free but redirect candidates to JobAdder. App integration keeps candidates on your website but requires Professional Services setup. Discuss options with your Account Manager for personalised advice.

Q4: What is a legacy token and why do I need one?

  • Answer: A legacy token allows JobAdder to post jobs to your Access Volcanic website. It's required for the integration to work. You can set this up entirely yourself through your Admin Area.

Q5: What does "Do not use job external application URLs" setting do?

  • Answer: This setting prevents external application URLs from working on your website. If you're using the external application URL method, ensure this setting is not enabled in your site settings.

Q6: Applications are not appearing in JobAdder - what should I check?

  • Answer: First confirm your integration method. With external application link method, applications complete in JobAdder and your website only logs clicks. With app integration method, applications should appear in JobAdder. Check the JobAdder app connection status and re-authorise if it shows a red X. After reconnecting, monitor whether applications are retriggered.

Q7: New candidates are not found in JobAdder - how do I fix this?

  • Answer: Ensure the JobAdder app shows a green tick status in your Admin Area. If authorised but candidates still don't appear, contact Support. Provide candidate details, time of registration, and mention this relates to JobAdder integration. Always verify your integration method before troubleshooting.

Q8: Why are applications showing as clicks instead of completed applications?

  • Answer: Applications show as clicks instead of completed applications when you use the external application link method. With this method, candidates complete their applications directly in JobAdder rather than on your website. Your website only records the initial click.

Q9: Why are new locations not appearing on posted jobs?

  • Answer: New locations may not appear on posted jobs because the SEO Locations hierarchy is not structured correctly. Ensure your hierarchy follows the Country β†’ Region β†’ City format and that all levels are properly configured.

Q10: Does reconnecting the JobAdder app resend older applications?

  • Answer: Reconnecting the JobAdder app may resend older applications depending on your site configuration. Monitor your JobAdder account after reconnecting to check for any duplicate entries.

Q11: How do I know which integration method my organisation uses?

  • Answer: To determine your integration method, observe where candidates complete applications. External application link method redirects candidates to JobAdder's website. App integration method allows candidates to apply directly on your website.

Q12: What should I do if the JobAdder app keeps disconnecting?

  • Answer: If the JobAdder app keeps disconnecting frequently, contact Support for assistance. Provide details about when disconnections occur and any error messages you see during re-authorisation.

Q13: Can I change from one integration method to another?

  • Answer: You can change integration methods by contacting your Account Manager or Support team. This typically requires configuration changes that affect how applications are processed.

Q14: Do I need to set up SEO Locations for every job?

  • Answer: You need to set up SEO Locations for every geographical area where you want to post jobs. Once configured, these locations can be reused for multiple jobs in the same area.

Q15: What happens if I don't set up SEO Locations?

  • Answer: If you don't set up SEO Locations, jobs may not appear in the correct geographical areas on your website, or location-based filtering may not work properly for candidates searching for jobs.

Q16: How often should I check the JobAdder app connection?

  • Answer: You should check the JobAdder app connection status weekly or whenever you notice issues with application or candidate sync. Set up a regular monitoring routine to catch disconnections early.

Q17: Can multiple people manage the JobAdder integration?

  • Answer: Multiple people can manage the JobAdder integration as long as they have administrator access to your Access Volcanic Admin Area. Ensure multiple team members know how to re-authorise the connection if needed.. Ensure multiple team members know how to re-authorise the connection if needed.

Did this answer your question?