Connect Pinpoint
Scout connects to Pinpoint with your account’s subdomain and an API key a Pinpoint admin creates. It pulls jobs, pipeline stages, candidates and resumes, and can write screening results back as comments on the application.
Before you start
- You’re a Scout admin.
- You can open Settings → API & Webhooks in Pinpoint.
What you’ll need#
Subdomain + API key: your Pinpoint subdomain and an API key.
Get your credentials from Pinpoint#
In Pinpoint, open Settings → API & Webhooks.
Turn the Pinpoint API on, then open API Keys and create a key.
Give the key access to Jobs, Applications and Candidates, and copy it.
Note your subdomain: the part before .pinpointhq.com in your Pinpoint web address. For example, acme in acme.pinpointhq.com. It isn’t always your company name, so copy it from the address bar.
Connect in Scout#
Open Integrations, then click Connect beside Pinpoint.
Type your subdomain into Subdomain and paste the key into API key.
- Pasting your whole Pinpoint address works too: Scout keeps just the subdomain.
Check the Label and Region.
- Label: a name for this connection. It starts as the ATS’s own name.
- Region: the country Scout assumes for a candidate’s phone number when the number has no country code of its own.
Click Connect Pinpoint.
ResultPinpoint appears under Your connections as Syncing, and its jobs start arriving in Jobs.
What syncs#
Jobs, pipeline stages, candidates and resumes. Confidential jobs come in too, like any other job. Candidates and resumes come in for the jobs you assign to a workflow. See How syncing works.
Write-back#
Screening results go back as a comment on the application, once an admin turns them on in ATS write back. Pinpoint posts every comment from your account as its system user, so there’s no one to choose. For Pinpoint you can also send:
- Tags: Scout’s own “Scout:” tags on the application. Other tags are left as they are.
- Custom fields: create them as application custom fields in Pinpoint first. Scout never creates them.
- Document: the call summary and transcript, uploaded to the application. Pinpoint can’t remove a document once it’s uploaded.
- Assessment, if the dialog lists it: a card on the application that links to the candidate in Scout. Each update replaces it.
Open in Scout: Open Integrations