Pinpoint
Connect Pinpoint so that Talent Unlimited can pull in your jobs and applicants, screen them with SmartScreen, then send the results back to Pinpoint as comments, tags and stage changes.
This guide is for the admin who sets up the connection. You need to be signed in to Talent Unlimited and Pinpoint at the same time. There are three steps:
- Create an API key in Pinpoint.
- Connect Pinpoint in Talent Unlimited.
- Set up a webhook in Pinpoint, so changes reach Talent Unlimited straight away.
Before you start
Section titled “Before you start”You need:
- A Talent Unlimited admin account.
- A Pinpoint admin account. You need it to create an API key and a webhook.
- Your Pinpoint subdomain. Look at the address you use to sign in to Pinpoint. For example, if it is
https://yourcompany.pinpointhq.com, your subdomain isyourcompany.
Step 1: Create an API key
Section titled “Step 1: Create an API key”The API key lets Talent Unlimited read your jobs and applications, and send results back.
-
Sign in to Pinpoint as an admin.
-
Go to Settings, then Integrations.
-
Open My Apps, then click Pinpoint API.
-
Make sure the integration is enabled, then click Create New.
-
Give the key a name, such as
Talent Unlimited. -
Choose the key’s permissions. We recommend you click Assign All, so that the integration keeps working as we add features.
If you prefer to give only the permissions Talent Unlimited uses today, choose these:
Permission Access Application Read and write Candidate Read and write Comment Read and write Department Read Division Read Job Read and write User Read and write -
Create the key, then copy it. You paste it into Talent Unlimited in the next step.
Step 2: Connect Pinpoint
Section titled “Step 2: Connect Pinpoint”- In Talent Unlimited, go to Settings, then Integrations.
- Click Pinpoint.
- Click Add integration.
- Enter:
- Subdomain: your Pinpoint subdomain, such as
yourcompany. - API Key: the key you created in step 1.
- Subdomain: your Pinpoint subdomain, such as
- Leave Webhook Secret empty for now. You get it in the next step.
- Click Save.
- Make sure the switch at the top of the page is set to Enabled.
As soon as you connect, we pull in all your jobs and applications from Pinpoint.
Options
Section titled “Options”After you connect, you can choose these options. Click Save when you are done.
- Use ATS departments as brands: map departments from Pinpoint as separate brands in Talent Unlimited.
- Auto-generate skills: fill in missing skills and qualifications from Pinpoint using AI.
- Auto-publish jobs: jobs with all required fields are published and start processing applicants automatically.
Step 3: Set up a webhook
Section titled “Step 3: Set up a webhook”The webhook tells Talent Unlimited straight away when a job or application changes in Pinpoint. Without it, jobs and applicants you add in Pinpoint later do not reach Talent Unlimited.
-
In Talent Unlimited, copy your webhook URL from the Pinpoint integration page.
-
In Pinpoint, go to your Company profile page, then open the Webhooks tab.
-
Click New Webhook.
-
Paste your Talent Unlimited webhook URL, then create the webhook.
-
Under Events to send, turn on these four events:
- New application
- Application stage changed
- Job created
- Job updated
Leave the other events off.
-
Copy the Signing Secret.
-
Back in Talent Unlimited, paste it into Webhook Secret on the Pinpoint integration page, then click Save.
How it works
Section titled “How it works”Jobs from Pinpoint
Section titled “Jobs from Pinpoint”Jobs from Pinpoint arrive in Talent Unlimited as Draft. This gives you time to check each job’s SmartScreen settings before any applicants are screened. If you turn on Auto-publish jobs, jobs with all the required fields are published straight away instead.
When you publish the job in Talent Unlimited, we pull in all of its applicants and screen them. Each SmartScreen result is sent back to Pinpoint.
New jobs and applicants that you add in Pinpoint later are pulled in automatically.
Jobs from Talent Unlimited
Section titled “Jobs from Talent Unlimited”When you publish a job in Talent Unlimited, we create it in Pinpoint too, as a draft. Finish setting up its workflow in Pinpoint, so that applicants keep syncing.
Candidates who apply through the Talent Unlimited application link are added to the job in Pinpoint.
Updates in Pinpoint
Section titled “Updates in Pinpoint”When something happens to an applicant in Talent Unlimited, we update their application in Pinpoint. For example, when:
- Their SmartScreen passes or fails.
- They are shortlisted or rejected.
- They are invited to an interview, start it or finish it.
Depending on the update, we add:
- A comment with a link to the candidate’s results in Talent Unlimited.
- A tag, so you can filter applicants quickly.
- A stage change, but only when someone does something by hand, such as rejecting an applicant.
Pinpoint stays in charge
Section titled “Pinpoint stays in charge”Pinpoint is the source of truth for your candidates. When you move an application to a new stage in Pinpoint, Talent Unlimited updates its status to match. For example, if you reject an applicant in Pinpoint, they are rejected in Talent Unlimited too.
What syncs
Section titled “What syncs”| From | To | What |
|---|---|---|
| Pinpoint | Talent Unlimited | Jobs, as drafts |
| Pinpoint | Talent Unlimited | Applicants and candidates for published jobs |
| Pinpoint | Talent Unlimited | Application stage changes |
| Talent Unlimited | Pinpoint | Jobs published in Talent Unlimited, as drafts |
| Talent Unlimited | Pinpoint | Applications made through Talent Unlimited |
| Talent Unlimited | Pinpoint | SmartScreen and interview updates, as comments and tags |
| Talent Unlimited | Pinpoint | Actions taken by hand, such as rejecting an applicant, as stage changes |
Troubleshooting
Section titled “Troubleshooting”New jobs or applicants do not appear in Talent Unlimited
Section titled “New jobs or applicants do not appear in Talent Unlimited”Check the webhook in Pinpoint. The URL must match the one on the Pinpoint integration page in Talent Unlimited, and all four events in step 3 must be turned on. Also check that the Webhook Secret in Talent Unlimited matches the Signing Secret in Pinpoint.
Applicants for a job are not being screened
Section titled “Applicants for a job are not being screened”Jobs from Pinpoint arrive as drafts. Check the job’s SmartScreen settings in Talent Unlimited, then publish it.
Updates take a while to appear in Pinpoint
Section titled “Updates take a while to appear in Pinpoint”Pinpoint limits how many requests we can make at once. When a lot changes together, for example when you publish a job with many applicants, we space out our updates, so some can take a little longer to arrive.
Still stuck?
Section titled “Still stuck?”Email support@talentunlimited.io.