Use the Pinpoint integration to start Decision Agent assessments from Pinpoint, invite candidates through the normal Decision Agent campaign flow, and return assessment status, report links, tags, and optional stage movement in Pinpoint.
Overview
What the integration does
Decision Agent treats Pinpoint as the source of the candidate and application action. Decision Agent remains the system that creates the assessment invite, runs the assessment, and generates the recruiter report.
- A recruiter starts a Decision Agent assessment from the Pinpoint candidate or application workflow.
- Pinpoint sends candidate, job, and application context to Decision Agent.
- Decision Agent creates or reuses the matching campaign applicant, creates the invite link, and sends the normal campaign invite email.
- As the assessment progresses, Decision Agent sends updates back to Pinpoint so the application can show current assessment status and report links.
- When configured on a campaign, Decision Agent can also move Pinpoint candidates to the next stage or to specific progressed, rejected, expired, or withdrawn stages.
Account setup
Connect Decision Agent to Pinpoint
Complete these steps once for each Decision Agent account that should receive assessments from Pinpoint.
Step 1
Open the Decision Agent integration settings
In Decision Agent, go to Settings, choose Integrations, then expand Pinpoint. Only account admins can manage the connection.
Step 2
Configure the Decision Agent plugin in Pinpoint
Generate a Decision Agent token and paste it into the Decision Agent plugin configuration in Pinpoint. If the token is lost or exposed, rotate it and update Pinpoint with the new value.
Step 3
Enter your Pinpoint REST details
Add your HTTPS Pinpoint base URL, usually your Pinpoint tenant URL on pinpointhq.com, and paste a Pinpoint REST API key from Pinpoint. Save the settings before testing.
Step 4
Test and enable the connection
Use Test connection to confirm Decision Agent can call Pinpoint with the saved base URL and API key. The test also reports whether Decision Agent has seen inbound Pinpoint plugin traffic. If the API test passes but plugin traffic is unknown, make sure Pinpoint has been configured with the generated token. When the test passes, switch the integration to Active so Pinpoint requests and Decision Agent result updates can run.
Required Pinpoint API key permissions
When creating the Pinpoint API key, set these exact permission levels:
- Application
- Write and Read
- Candidate Assessment
- Read
- Job
- Read
- All other Pinpoint API areas
- No permissions
Campaign setup
Map Pinpoint outcomes for each campaign
After the account connection is active, configure campaign-specific behavior from the campaign details page. This keeps stage movement aligned with the Pinpoint job and process used for that hiring workflow.
- Select the Pinpoint job. Choose the job whose stages should appear in Decision Agent.
- Set progressed movement. Leave candidates in place, move them to the next stage, or move them to a selected stage.
- Set rejected movement. Optionally move candidates to a selected stage when they are rejected, expired, cancelled, or withdrawn.
Administration
Manage the integration over time
Keep credentials current, pause the integration when needed, and test from Decision Agent before escalating a Pinpoint workflow issue.
Rotating credentials
Rotate the Decision Agent token from the Integrations page, then replace it in Pinpoint. Update the Pinpoint API key in Decision Agent whenever the key is rotated in Pinpoint.
Temporarily pausing the integration
Set the Pinpoint switch to Inactive. Existing assessment links and applicants remain in Decision Agent, but new Pinpoint traffic should not be processed while the connection is inactive.
Changing stage movement
Open the campaign in Decision Agent and use the Pinpoint panel in the campaign details area. Select the Pinpoint job first so the correct stage list is available.
Checking failures
Start with Test connection for Decision Agent to Pinpoint API access. If that passes but Pinpoint still cannot start assessments, check that the Pinpoint plugin is active and has the current Decision Agent token.