Pinpoint integration
Send HiveRef reference checks from Pinpoint
Start a HiveRef reference check from any application in Pinpoint, or automatically when a candidate reaches a stage. Pinpoint shows where each check is up to and links to the finished report in HiveRef.
Setup
Connect Pinpoint to HiveRef
You need a HiveRef account (owner or admin) and a Pinpoint admin.
- 1.Sign in to HiveRef, open Settings > API and create an API key named "Pinpoint". Only organisation admins can create keys. Copy the key.
- 2.In Pinpoint, go to Settings > Integrations, open HiveRef and paste the key into HiveRef API key. Save.
- 3.On a candidate's application, choose Send HiveRef reference check, pick a question template and the number of referees, and send.
- 4.Optional: add Send HiveRef reference check as a stage action on a hiring workflow stage (for example "References"), so the check goes out automatically when a candidate reaches it, including bulk moves.
How it works
What happens after you send a check
HiveRef emails the candidate a secure link to add their referees, then collects structured, consent-based references online and turns them into a clear report. Pinpoint shows the status on the application:
| Status in Pinpoint | What it means |
|---|---|
| Invited | HiveRef emailed the candidate a secure link to add their referees. |
| In progress | The candidate added their referees and HiveRef is collecting references. Shows how many are in. |
| Completed | Every referee has responded. Pinpoint shows a link to the HiveRef report. |
- Each check uses one reference check from your HiveRef plan or trial.
- Sending the same template for the same application again while a check is running does not email the candidate twice or use a second check.
- Checks are sent as the HiveRef user who created the API key.
Data
What moves between Pinpoint and HiveRef
Pinpoint to HiveRef
Candidate first name, last name and email, the job title, the Pinpoint application id, the chosen question template and the number of referees.
HiveRef to Pinpoint
The status, how many references are in, a one-line summary and links to the check and report in HiveRef. Referee details and answers stay in HiveRef, behind your team's sign-in.
Disconnect
Remove the key from the HiveRef integration in Pinpoint, or revoke it in HiveRef under Settings > API. Checks already sent carry on in HiveRef.
Questions? Email theteam@hiveref.com.