Pinpoint Integration

How to Integrate Testlify with Pinpoint

This help article guides you through the process of integrating Testlify with Pinpoint. By following these steps, you can set up an automated system for inviting candidates to assessments directly through Pinpoint.

Step 1: Start Testlify Integration on Pinpoint

1. Open Testlify Settings
   • Log in to Testlify and go to Settings → Integrations.
   • From the list, click Pinpoint.

2. Provide Your Pinpoint Credentials
   • A new tab will open and prompt you for your Pinpoint API Key and Subdomain.
     • API Key: In Pinpoint, go to Settings → Integrations. Click “Generate API Key” (see the video in the popup for guidance).
     • Subdomain: This is the name you use to log in, e.g. your-subdomain.pinpointhq.com .
   • Copy the Subscription URL shown on Testlify (you’ll need it in the next step), then click Save.

3. Create a Webhook in Pinpoint
   • In Pinpoint, navigate to Company Profile → Webhooks, and click New Webhook.
   • Paste the Subscription URL you copied from Testlify, then click Create Webhook.

   • Once created, find your new webhook in the list, expand its Events section, and enable Application stage changed.

     Enabling this event ensures that Testlify receives notifications when a candidate moves stages in Pinpoint to send the candidate invitation for particular linked assessment.

4. Confirm the Connection
   • Return to Testlify’s integration tab. You should see Pinpoint listed as “Connected.”
   • Click Continue to finish Step 1.

Finally, the Pinpoint integration will be available & visible on the Testlify Settings page under Integrations Tab.

Step 2: Setup Assessment Level Integration

1. Configure Your Assessment
   • In Testlify, create a new assessment (or edit an existing one) with your desired job role, assessment name, and questions.

2. Set Up the ATS Integration

   • Within the assessment’s Settings → Integrations tab, click the Link button.

     From the dropdowns, choose:

     • ATS: Pinpoint
     • Job Profile: Select the open job you want to link
     • Invitation Stage: The Pinpoint stage at which candidates should receive the Testlify invite
     • Completion Stage: The Pinpoint stage for candidates who finish the assessment
   • Click Link, then Save to apply these settings.

Step 3: Invite Candidates to Assessment

1. Move Candidates to the Invitation Stage
   • In Pinpoint, go to Jobs → Manage Jobs → [Your Job] → Candidates.
   • Select the candidate(s) you wish to invite and move them to the Invitation Stage you configured in Step 2.

2. Verify the Invitation
   • The candidate will receive an email from Testlify (e.g. “You’ve been invited to Demo Pinpoint Assessment”).
   • In Testlify, open your linked assessment and confirm the candidate appears in the Invited list.

3. Check Pinpoint Application Fields
   • In Pinpoint, under Jobs → Manage Jobs → [Your Job] → Candidates → Invited Candidates → Application, scroll to Custom Fields.
   • Verify that Testlify Assessment Status is set to Invited.

4. Review Completed Assessments
   • When a candidate finishes the assessment, Pinpoint will automatically move them to your designated Completion Stage.
   • You’ll receive a system notification with a comment containing their assessment results, click the candidate’s name to view details.
   • In the candidate’s Application section, confirm all Testlify custom fields (score, status, assessment results, etc.) are populated.