1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. HRIS and onboarding

Aquera HR application integration

Aquera’s HR application integration with Greenhouse Recruiting allows organizations to scale complex data management by automating the synchronization of candidates from the Greenhouse Recruiting application to HR applications.

In this article

Create a Harvest API Key

To configure the Aquera integration, you will need to create a Harvest API key.

Follow the steps in this article to create the API key, and verify that the permissions below are selected when configuring the Aquera integration.

Credentials

In the Create New API Key box, make the following selections:

  • API type: Harvest
  • Partner: Aquera or Unlisted Vendor
  • Description: Aquera Harvest API Key

Permissions

Verify that the following permissions are selected for the Aquera integration:

  • Candidates
    • Delete: Delete Candidate
    • Delete: Delete Education
    • Delete: Delete Employment
    • Get: Retrieve Candidate
    • Get: List Candidates
    • Patch: Edit Candidate
    • Post: Add Candidate
    • Post: Add E-mail
    • Post: Add Note
    • Post: Add Attachment
    • Post: Add Application
    • Post: Add Education
    • Post: Add Employment
    • Post: Add Prospect
    • Put: Anonymize Candidate
    • Put: Merge two candidates
  • Offers
    • Get: List Application's Offers
    • Get: Retrieve Application's Current Offer
    • Get: Retrieve Offer
    • Get: List Offers
    • Patch: Update Application's Current Offer
  • Jobs
    • Get: Retrieve Job
    • Get: List Jobs
    • Patch: Update Job
    • Post: Create a new job
  • Custom Fields
    • Delete: Delete custom field
    • Get: Get custom fields
    • Patch: Update custom field
    • Post: Create custom field

Use the Aquera Integration with Greenhouse Recruiting

Use the Aquera Integration with Greenhouse Recruiting to import candidates from the Greenhouse Recruiting application and provision the offer accepted candidates in Ceridian Dayforce, which is an HR application, using Aquera's Data Synchronization Orchestration.

To integrate with the applications of your interest, check Aquera's Application Catalog.

The following is the Aquera Flow Map showing data flow from the Greenhouse Recruiting application to the Ceridian Dayforce application through Aquera's Data Synchronization Orchestration:

With this integration, you can import candidates from the Greenhouse Recruiting application, filter candidates (for example, filter based on the status of the job offer accepted), and provision these candidates in HR applications such as Ceridian Dayforce.

Prerequisites

The following are the prerequisites:

  • Tenant Account in the Aquera Admin Portal: You must have a tenant account in the Aquera Admin portal. Visit https://admin.aquera.io and register to get a tenant account. Contact your Aquera account manager to get the Aquera tenant access. Note: If your organization is in the EU region, use the following URL to register: https://admin.eu.aquera.io/
  • Administrator access to the Greenhouse Recruiting application: You must have the admin credentials for your Greenhouse Recruiting application.
  • API Key: You must create an Harvest API Key as mentioned in the previous section for authenticating the API requests. The Greenhouse Recruiting connector leverages the Greenhouse Harvest API to retrieve candidates from the Greenhouse Recruiting application.

Configure the Greenhouse Recruiting Connector

You need to configure the Greenhouse Recruiting connector in the Aquera Admin portal to retrieve candidates from the Greenhouse Recruiting application.

Supported Resources and Operations

The following resource supported by the Greenhouse Recruiting connector is used for this integration:

Candidates

  • Retrieve all candidates.
  • Retrieve information of a candidate.

Configuration

Perform the following steps to configure the Greenhouse Recruiting connector in the Aquera Admin portal:

  • Log in to the Aquera Admin portal.
  • Navigate to Applications and click Add Application in the Aquera Admin portal.
  • Search for Greenhouse Recruiting and click the Greenhouse Recruiting icon.
  • Enter the values for the following fields under the Configuration tab:
    • Basic Details:
    • Display Name: Enter a display name for your application.
    • Description: Enter a description for your application.
    • Source Connection Type: Select Direct Connection.

      Note: This field is available only if you have access to Aquera's File Collection module.

    • Source Owner: Enter a valid email ID of the source owner(s).
    • Subscribe error notification: Select this checkbox to send notification emails to source owner(s) for any errors in the user data transactions.
    • Pick your Protocol: Select the protocol as SCIM to populate the fields in the Schema accordingly.
    • Copy this URL: This is the interface URL to the Greenhouse Recruiting connector. Copy this URL and paste it at the time of provisioning in the identity service provider.
  • Click Create to create the Greenhouse Recruiting connector.

A screenshot of a computer Description automatically generated

Refer to the Greenhouse Recruiting Configuration Guide for detailed configurations and schema attributes.

Configure an HR Connector

You need to configure an HR connector in the Aquera Admin portal to provision the job offer accepted candidates in an HR application. Refer to the respective connector configuration guides in the Aquera Help Center for details on configuring an HR connector.

For this integration, we are considering Ceridian Dayforce as the HR connector.

Supported Resources and Operations

The following resource supported by the Ceridian Dayforce connector is used for this integration:

Employees

  • Retrieve all employees.
  • Retrieve information of an employee.
  • Create an employee.
  • Write back the email address, login ID, phone number, employee properties, and federatedId attributes of an employee.

Configuration

Perform the following steps to configure the Ceridian Dayforce connector in the Aquera Admin portal:

  • Log in to the Aquera Admin portal.
  • Search for Ceridian Dayforce and click the Ceridian Dayforce icon.
  • Enter the values for the following fields under the Configuration tab:
    • Basic Details:
    • Display Name: Enter a display name for your application.
    • Description: Enter a description for your application.
    • Tenant: Enter the hostname available in your Dayforce login URL. The login URL varies based on your instance type. The tenant value will be one of the following based on your Dayforce instance:
    • Test instance: test.dayforcehcm.com
    • Production instance: www.dayforcehcm.com
    • Config instance: config.dayforcehcm.com
    • Any self-maintained instances: The tenant value differs based on the hostname in your login URL. For example, aquera.dayforcehcm.com
    • Source Connection Type: Select Direct Connection. Note: This field is available only if you have access to Aquera's File Collection module.
    • Source Owner: Enter a valid email ID for the source owner(s).
    • Subscribe error notification: Select this checkbox to send notification emails to the source owner(s) for any errors in the user data transactions.
    • Pick your Protocol: Select the protocol as SCIM to populate the fields in the Schema accordingly.
    • Copy this URL: This is the interface URL to the Ceridian Dayforce connector. Copy this URL and paste it at the time of provisioning in the identity service provider.
  • Click Create to create the Ceridian Dayforce connector.

Refer to the Ceridian Dayforce Configuration Guide for detailed configurations and schema attributes.

Set Up the Aquera Data Synchronization Orchestration

Aquera's Data Synchronization Orchestration provides the automatic synchronization of candidates from the Greenhouse Recruiting application to HR applications such as Ceridian Dayforce.

Perform the following steps to create a Data Synchronization Orchestration:

  1. Log in to the Aquera Admin portal.
  2. Navigate to Orchestrations and click Create Orchestration.
  3. Enter a name for the orchestration in the Add Orchestration pop-up window and select Data Synchronization from the list of orchestration types.
  4. Click Done. A new page with the fields and tabs to configure the orchestration is displayed.
  5. Select Greenhouse Recruiting connector as the Source Application. Select Candidate as the Source Resource Type. Select Ceridian Dayforce connector as the Target Application. Select Employee as the Target Resource Type.
  6. Click Create to create the orchestration.

You can configure the required fields in the Configuration tab based on your use case.

The Attribute Map tab allows you to map source attributes from the Greenhouse Recruiting application to the target attributes in the Ceridian Dayforce application.

By default, attributes with similar names will be mapped from the source to the target application. However, you can edit the source attribute field to include JavaScript expressions that should be mapped to the corresponding target attribute. The following is a sample attribute mapping:

Synchronize Candidates

You can click the Execute button at the top right of the Data Synchronization Orchestration to manually run the orchestration. You can also schedule the Data Synchronization Orchestration to run automatically at specified time intervals by configuring a time-frequency in the Schedule tab. You can navigate to Logs > Orchestrations in the Aquera Admin portal to view the logs of the orchestration execution.

The following is a sample candidate who has received the job offer in the Greenhouse Recruiting application:

A screenshot of a job search Description automatically generated

After the Data Synchronization Orchestration is successfully executed, the following new employee is created in the Ceridian Dayforce application for the offer accepted candidate of the Greenhouse Recruiting application:

Additional resources

For additional information or troubleshooting not covered here, reach out to Aquera support at support@aquera.com.