Building Custom Integrations

Interested in linking JazzHR with another app or web service with whom we don't natively integrate?

Use our custom integration framework to securely send candidate data from JazzHR to another software (i.e. HRIS/payroll systems/background check or assessment providers). This framework also supports homegrown systems and generic task apps, like Zapier, Automate.io and others.

Custom integrations use candidate webhooks to move candidate information from one app to another. Building a custom integration will require development participation from either an internal team and/or the third-party software provider.

Note also that our custom integration framework only currently supports the sending of candidate data from JazzHR, but does not support receiving any data from other apps or web services.

To start building and using a custom integration:

Engage the JazzHR Team

Fill out the following form to provide us with information on your desired integration: http://info.jazzhr.com/Custom-Integration-Request_LP.html

We'll reach out them on your behalf and keep you posted on the integration's progress.

Set Up the Integration

Once the third-party system has built to the JazzHR API, head into JazzHR to set up this integration:

  1. Click Settings.
  2. Click Integrations.
  3. Scroll down to the "Custom Integrations" block.
  4. Click Add Custom Integration.
  5. Enter the following:
    1. Integration Name - This should be the name of the integration and will show up when exporting candidates. Example: Time Rack
    2. Integration [webhook] URL - Enter the webhook URL to where JazzHR should send the candidate payload.
    3. Secret Key - Used to map a JazzHR account to the correct partner account
  6. Click Save.

2019-01-30_12.07.54.gif

Export a Candidate

Once the integration is connected, follow the steps below to trigger a candidate payload to the specified webhook URL. To export an individual candidate:

  1. Click Candidates.
  2. Search for the candidate who you'd like to export.
  3. Click on the drop-down menu located next to the candidate’s Workflow Status
  4. Click Export Candidate.
  5. Choose the Integration Name that you chose in setup.
  6. Click Export.

2019-01-30_12.11.51_2.gif

To add an export as a Workflow Helper:

  1. Click Settings.
  2. Click Workflows.
  3. Click into the Workflow to which you want to add this.
  4. Click Add next to the stage on which you want this associated.
  5. Select Send to [custom integration name] from the drop-down.

2019-01-30_12.29.14.gif

Was this article helpful?
0 out of 0 found this helpful