Recruitment Marketing Public

This guide will walk you through the process of integrating your Oracle HCM account with Recruitment Marketing.

Setup in Oracle HCM

Before setting up the integration within Recruitment Marketing, you will need to have an administrator of your Oracle HCM system create API credentials which have access to the Recruiting endpoints in the Oracle Fusion REST API. 

For information on the Oracle Fusion Cloud HCM API, refer to Oracle's developer documentation available here.

Setup in Recruitment Marketing

1. From the side menu, under Integrations click ATS.
2. Click the New button.
3. Click the Oracle HCM logo.
4. Complete the form details:
   1. Name: Enter a description name for this integration.
   2. API host name: Obtained from Oracle.
   3. Public site host name: Obtained from Oracle, and used to redirect candidates to the application process in the ATS.
   4. Username: Enter the username created in the Set-up in Oracle HCM step above.
   5. Password: Enter the password created in the Set-up in Oracle HCM step above.
   6. Language code: Usually set to "en".
   7. Site code: Enter the site code for Oracle HCM site.
   8. Audience: Select the relevant option of "external" or "internal".
   9. How are remote jobs identified: Select the appropriate option to identify remote jobs.
   10. Regex to match remote job locations: Specify the RegEx to identify fully remote jobs.
   11. Regex to match hybrid job locations: Specify the RegEx to identify hybrid remote jobs.
   12. Identify hidden jobs using a jobs criteria: Specify the logic for identifying hidden jobs.
   13. How often do you want to read jobs from the ATS: 15 minutes is recommended.
   14. How often do you want to read candidate data from the ATS: 1 hour is recommended.
   15. Date to start synchronising candidates: Normally left blank to just pull the most recent candidate updates.
   16. Import unknown candidates?: Determines whether to bring in candidates from the ATS who don't already have a matching profile within the Recruitment Marketing CRM database.
   17. Sync application resumes: Tick this option if you want to import candidates' resumes during the synchronisation process.
5. Click Save.

With your Oracle HCM integration in place, your jobs will now be live and searchable on your Recruitment Marketing careers site. Utilising our templating feature, a branded job page will be automatically generated for each job. These pages will automatically update to reflect any changes made to the job description content in the ATS.

Job Data Integration

When enabled, the job data integration will pull in the following job data (where available) from Oracle HCM:

• Job title
• Job description
• Apply URL
• Employment type
• Remote job
• Job location(s).

Candidate Data Integration

When enabled, the candidate data integration will pull in the following candidate data (where available) from Oracle HCM:

• First name
• Last name
• Email address
• Employment history (if available)
• Candidate documents (if available)
• Job application statuses.

The system can optionally be configured to parse the candidate's resume document to extract education and employment history.