Skip to content

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:

  1. Create an API key in Pinpoint.
  2. Connect Pinpoint in Talent Unlimited.
  3. Set up a webhook in Pinpoint, so changes reach Talent Unlimited straight away.

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 is yourcompany.

The API key lets Talent Unlimited read your jobs and applications, and send results back.

  1. Sign in to Pinpoint as an admin.

  2. Go to Settings, then Integrations.

  3. Open My Apps, then click Pinpoint API.

  4. Make sure the integration is enabled, then click Create New.

  5. Give the key a name, such as Talent Unlimited.

  6. 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
  7. Create the key, then copy it. You paste it into Talent Unlimited in the next step.

  1. In Talent Unlimited, go to Settings, then Integrations.
  2. Click Pinpoint.
  3. Click Add integration.
  4. Enter:
    • Subdomain: your Pinpoint subdomain, such as yourcompany.
    • API Key: the key you created in step 1.
  5. Leave Webhook Secret empty for now. You get it in the next step.
  6. Click Save.
  7. 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.

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.

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.

  1. In Talent Unlimited, copy your webhook URL from the Pinpoint integration page.

  2. In Pinpoint, go to your Company profile page, then open the Webhooks tab.

  3. Click New Webhook.

  4. Paste your Talent Unlimited webhook URL, then create the webhook.

  5. Under Events to send, turn on these four events:

    • New application
    • Application stage changed
    • Job created
    • Job updated

    Leave the other events off.

  6. Copy the Signing Secret.

  7. Back in Talent Unlimited, paste it into Webhook Secret on the Pinpoint integration page, then click Save.

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.

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.

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 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.

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

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.

Email support@talentunlimited.io.