JazzHR

Authentication & Authorization

Credentials

• JazzHR connects via basic authentication using a special API Key as credentials.

• API Key can be generated in the JazzHR account in the settings menu (see the DataGrail Help Docs).

• Publicly exposing your API credentials can allow unauthorized access to the JazzHR API endpoints, and your JazzHR data by a third party. DataGrail stores your API credentials encrypted and protected.

Permissions

No special permissions required to connect API with related credentials.

Endpoints Utilized

DataGrail uses the following endpoint to validate that credentials are good based on a successful response:

• GET https://api.resumatorapi.com/v1/applicants

Version

JazzHR integration currently supports API version 1.0 (v1).

Limits

DataGrail processes API responses with HTTP 429 status to interrupt requests, waiting and retrying (using an exponential backoff strategy).

Access

For an access request, DataGrail will take the following actions:

• Get a list of applicants and find data subject via identifier (email and/or phone).

• Get the details from a single applicant using “applicant_id”.

• Get files for each applicant.

• Get questionnaire answers for each applicant.

• Get a list of contacts and find data subject via identifier (email and/or phone).

• Get contact details from a single applicant using contact_id.

DataGrail also supports the Direct Contact Access workflow for JazzHR.

Endpoints Utilized

• GET https://api.resumatorapi.com/v1/applicants

• GET https://api.resumatorapi.com/v1/applicants/id

• GET https://api.resumatorapi.com/v1/files/applicant_id/applicant_id

• GET https://api.resumatorapi.com/v1/questionnaire_answers/applicant_id/applicant_id

• GET https://api.resumatorapi.com/v1/contacts

• GET https://api.resumatorapi.com/v1/contacts/id

Deletion

DataGrail supports the Direct Contact Deletion workflow for JazzHR.