Overview
Integrating Vincere with your Access Volcanic site allows you to:
Post jobs from Vincere to your Volcanic website.
Retrieve candidate applications and registration data into Vincere.
This enables seamless job syncing and streamlined hiring workflows.
📌 Note: This article builds on the Integrations and explains how to create Legacy Tokens and request integrations.
Key Benefits
Automated Job Posting: Instantly post jobs from Vincere to Volcanic.
Candidate Sync: Retrieve candidate applications and registrations.
Complete Field Mapping: Align job and user data fields between platforms.
Error Prevention: Field validation ensures clean data transfers.
Admin-Only Setup: No developers needed.
Two-Way Efficiency: Manage jobs and candidates in one place.
Integrated Un-posting: Remove jobs from Volcanic via Vincere.
What You Need Before Starting
Admin access to the Access Volcanic Admin Area
Admin access to Vincere
📌 Note: Click on the link ➤ to expand the section you're interested in:
Set Up Vincere Job Posting
Set Up Vincere Job Posting
Create a Legacy Token in Volcanic
Log in to the Volcanic admin area, then click the Settings tab.
Click Apps (under Site), then click the Legacy Tokens tab.
Click the + New button and fill out the form:
Name: Integration name (e.g., Vincere).
Domain: Your Volcanic website domain (e.g., https://www.example.com).
Locale*: Add the locale for your jobs (e.g., en).
Location locale*: Add the locale for your job locations (e.g., en).
Add required Permissions:
Clients:
Create Client
List Clients (mandatory)
Disciplines:
Create Discipline
List Disciplines
Job Functions:
Create Job Function
Job Types:
Create Job Type (mandatory)
List Job Types
Jobs:
Create Job
Fetch Job
List Job
Expire Job
Delete Job
Taxonomy:
Available User Attributes
Available Job Attributes
Users:
Fetch User (needed for candidate retrieval)
Select optional settings as needed:
Default job expiry date: 30 days.
Send invitation emails to new users?
Click Create Legacy Token and copy the API Key when it appears.
📌 Note: A green banner displays the API Key after creation. Copy and save it immediately. This only appears once.
Determine Your Volcanic End Point
Choose the API URL based on your hosting stack:
Stack | URL |
EU | https://api.eu-2.volcanic.cloud/ |
AUS | https://api.aus-2.volcanic.cloud/ |
MANPOWER | https://api.manpower.volcanic.cloud/ |
US | https://api.us-2.volcanic.cloud/ |
🤓 Tip: Your staging site URL reveals your stack. (e.g. a staging link with .eu-2. means EU stack). Contact Volcanic Support if unsure.
Enable the Volcanic Integration in Vincere
Once your Legacy Token has been set up in Access Volcanic and you’ve copied the API Key and API URL, follow these steps to enable the integration from Vincere:
Log in to Vincere (Admin account).
Click Settings, then click on Marketplace.
Find the Access Volcanic tile.
Click the Setup tab, then select Enable Volcanic.
Fill in:
Volcanic Name: Name of your Volcanic website.
Volcanic API Key: Paste the Legacy Token API Key.
Volcanic End Point: Full Volcanic Endpoint, including https:///.
Click Connect.
Map Volcanic Fields in Vincere
Log in to Vincere (System administrator).
Click Settings, then click on Marketplace.
Find the Access Volcanic tile.
Click the Job Field Mapping tab.
To add fields, click the + button.
To Remove fields, click the - button
Click Save.
📌 Note:
Mandatory fields are greyed out and uneditable.
Add fields one at a time.
Date fields must be mapped to another date field.
Not all fields are available for mapping.
Get started with Vincere x Volcanic job posting
Get started with Vincere x Volcanic job posting
Post a Job to Volcanic from Vincere
Log in to Vincere (end user role is fine).
Click Jobs, then select a job.
In the Action Panel, click Job Action.
Click Post, then switch to Public.
On the Volcanic tab, click Post.
Review or edit mapped field data in the Job Preview.
Click Post.
Watch the video below for your visual guidance:
📌 Note:
The data shown comes from the job’s Vincere profile.
Edited preview data doesn’t sync back to Vincere.
To keep info consistent, edit the job in Vincere first.
Update a Job in Volcanic via Vincere
Log in to Vincere.
Click Jobs, then select a job.
In the Action Panel, click Job Action.
Click Post.
Click Update, then click Update from the drop-down.
Review or edit mapped field data in the Job Preview.
Click Update.
Watch the video below for your visual guidance:
📌 Note: Changes made directly in Volcanic won’t reflect in Vincere.
Unpost a Job from Volcanic via Vincere
To remove a job posting in Volcanic from Vincere, you can follow the steps below:
Log in to Vincere
Click Jobs, then select a job.
In the Action Panel, click Job Action.
Click Post.
On the Volcanic tab, click Update.
Select Unpost, then click Yes to confirm.
The job is marked as Expired in Access Volcanic.
Watch the video below for your visual guidance:
📌 Note: Simply making a job Private or changing the Sourcing Close Date won't unpost it. Click Unpost.
Understanding Disciplines
Vincere creates disciplines in Volcanic when posting jobs.
Avoid duplicate or missing disciplines by matching discipline Reference values.
Follow the steps below to correctly match up your disciplines:
Match Disciplines
In Vincere, post a job with an unmatched discipline.
This creates a duplicate discipline in your Volcanic site.
In Volcanic, click Settings, then click Reference Data.
Select Disciplines, then edit the duplicate discipline.
Copy what's in the Reference. This is the Vincere Discipline ID.
Edit the original Volcanic discipline.
Paste the Vincere Discipline ID into the Reference field.
Delete the duplicate discipline.
🤓 Tip: You can also simply copy the content from the original Volcanic discipline to the new duplicate, and then delete the original instead.
Set up Vincere candidate retrieval
Set up Vincere candidate retrieval
Set up Candidate Sync in Volcanic
📌 Note: Contact Vincere Support to get your Vincere API Key.
Log in to Volcanic as an admin.
Click the Settings tab at the top.
Click Apps.
Click the Legacy Token at the top and edit the Legacy Token you created before.
Add the following permission:
Users:
Fetch User
Click Update Legacy Token.
Click Webhooks at the top.
Click the + New button.
Fill out the form:
Name: Add your Vincere Tenant Name (e.g., example-company.vincere.io)
Endpoint: [Your Vincere Tenant URL]/api/v2/simpleauth/volcanic/candidate
📌 Note: Ensure there are no spaces at the end of the URL.
Http method: POST
Content-Type: application/json
Headers:
Name: Add x-api-key
Value: Add your Vincere API Key
Select:
Async
Use V1 API Resources
Active
Retry interval: 1
Events: Add A user is saved, A job is applied for.
Click Create Webhook.
Enable Registrations and Applications in Vincere
Log in to Vincere using an Admin account
Click Settings, then click Marketplace.
Look for the Access Volcanic tile in the Marketplace.
Click the Settings tab.
To enable registrations, select:
Enable: Retrieve New Candidate Registrations from Volcanic as New Candidates.
To enable applications, select:
Enable: Retrieval New Applications - Add to Applications Stage.
Click Save.
📌 Note
Only the following candidate data is retrieved:
First Name
Last Name
Primary Email
CVs
and Cover Letters.
Other fields aren't currently supported.
Get started with candidate retrieval
Get started with candidate retrieval
After setting up candidate retrieval, you can use Vincere's Candidate Quick View for an efficient way to manage candidate profiles:
Quickly view and manage candidates without leaving your screen
Instantly access key candidate details like contact info, status, and application history.
View and manage notes, CVs, LinkedIn profiles, activity logs, and more.
Streamline workflow by reviewing candidates in a single view.
📌 Note: Explore how to get the most out of Candidate Quick View: Read the full article.
FAQs
Q1: Do I need a developer to set up the Vincere integration?
Answer: No. Admin users with appropriate access can complete the setup using the Admin Area and Vincere's Marketplace settings—no developer required.
Q2: How do I verify that the integration is working?
Answer: Post a test job from Vincere and confirm that it appears on your Volcanic site. Submit a test application to ensure candidate data is successfully pulled into Vincere.
Q3: What if I lose the API Key after creating a Legacy Token?
Answer: The API Key is shown only once and cannot be recovered. If lost, you will need to create a new Legacy Token and update the integration in Vincere.
Q4: Will updates made in Volcanic sync back to Vincere?
Answer: No. Changes made in Volcanic do not sync back. Always update job and candidate data in Vincere first and re-post if needed.
Q5: What candidate data is retrieved from Volcanic to Vincere?
Answer: Only the following candidate information is retrieved:
First Name
Last Name
Primary Email
CVs
Cover Letters
Q6: How can I find which API stack my Volcanic site uses?
Answer: Check your staging URL for clues (e.g.,
.eu-2.means EU stack). If you're unsure, contact Volcanic Support to confirm.
Q7: What happens if disciplines don’t match between Vincere and Volcanic?
Answer: A duplicate discipline may be created. You should match the Vincere discipline ID with the Volcanic Reference field to prevent duplication.