This article provides comprehensive guide on how to integrate employer accounts with Djinni job site in PeopleForce system. It covers the process of adding accounts, publishing vacancies, managing publication statuses, integrating existing publications, and synchronizing candidate data from the Djinni job site to the PeopleForce system.
Setting up the integration will allow PeopleForce to share certain recruiting data, such as hired candidate information, with Djinni.
The integration will allow PeopleForce to share certain recruiting data with Djinni, such as information about hired candidates.
Get started by adding an account to the job site
To integrate, please reach out to your manager at PeopleForce and request them to enable the integration for you. Once enabled, follow these steps to add your account to Djinni's job site:
Go to Settings > Integrations.
Select the integration with the Djinni job site.
Click the "Install" button.
In the window that appears, enter a name for your API key.
Don't see the section you need in your Djinni profile? Contact magic@djinni.co to request API access for you
5. Copy your API key from your profile on Djinni.
6. Paste it into the API Key field and save.
After successful addition, the account will appear in the installed integration.
Important! It is recommended to add integration only with an administrator account on Djinni, so that recruiters' accounts will be automatically pulled up.
Adding multiple employer accounts to the system
To add multiple employer accounts to the system, you can integrate multiple Djinni job sites accounts at the same time. To add additional accounts, simply repeat the process:
Go to the Integrations section in Settings.
Select the Djinni integration.
Click Install.
Enter the key name and the copied Djinni API key.
Save it.
Important! When you post a new job, you can choose which account to use. Once published, the employer account cannot be changed.
Integrating and publishing a vacancy
Create a new job in the Recruiting section. Make sure that the job title and description match the corresponding fields in the Details and Description sections. Fill in all required fields of the new job and save your changes.
In the created job, go to the Integration tab and click the Add button. In the drop-down menu, select the Djinni API key.
Fill in all required fields and click Save. If you intend to create a draft, you do not need to specify the type of publication. To publish the job, click the Publish button.
💡 The published vacancy must undergo approval by Djinni. Once it is checked for compliance with the platform's rules and criteria, it will be approved and subsequently published on the Djinni website.
Publication statuses
Draft - you have added an account, it is in the process of filling in the fields for further publication on the site.
Published - your job has been successfully published on the specified job site, candidates are synchronized (if the employer's API is active).
Inactive - you have disabled candidate synchronization, but the job posting will still be active on the site.
Error - your post, for example, does not contain required fields or has another error. You can always see it on the post page. If you have any questions about the information or errors displayed, you can always contact us.
Integration with an existing publication on the job site
If you already have an active job posting on the site, you can link this existing publication to a vacancy in PeopleForce. This allows you to continue working with the same posting while keeping all new candidates in a single vacancy pipeline.
To link an existing publication:
Create a vacancy in the Recruit tab or open an existing one.
Go to the Promotions tab and click +.
Select the employer account and job site you want to work with.
In the publication settings, choose the option to link an existing publication instead of creating a new one.
The system will show a searchable list of active job postings from the selected job site. Find and select the publication that corresponds to your vacancy.
In the same window, configure candidate synchronization:
All candidates: choose this option if you want to import the full history of applicants from this publication on the job site. All candidates associated with this posting will be transferred to the vacancy in PeopleForce.
From selected date: choose this option if you want to import only candidates who applied on or after a specific date. Existing postings often have a long history of candidates, and limiting synchronization to a specific date helps avoid importing outdated applications and keeps your pipeline clean and manageable.
If you select From selected date, set the date from which you want to start importing candidates (for example, today to work only with fresh applications).
Click Save to complete the integration.
Once the existing publication is linked, new candidates who apply via that job site will be automatically transferred to the connected vacancy in PeopleForce according to the candidate synchronization settings.
Synchronizing candidates
Once a vacancy is integrated with a publication on a job site (whether it was created from PeopleForce or linked as an existing publication), candidates who apply on the job site will automatically be transferred to the connected vacancy in PeopleForce according to the selected synchronization option.
How often are candidates transferred to the system?
Candidates are transferred unilaterally from the job site to PeopleForce and occur immediately after the integration of an active job posting from the system (if the job has already been published on the site before) every 30 minutes.
You can track how many candidates apply to your job through the main job page in the Integrations tab.
What data about a candidate will be automatically added to their profile?
All the fields that were filled in by the candidate when submitting a response to the job will be automatically pulled into their candidate profile.