Connect TieTalent to
One TieTalent API key, five steps. After setup, recruiters run Candidate Intelligence or Role Fit from Pinpoint applications or Stage Actions and see results on the application.
Video transcript
This walkthrough shows how to create a TieTalent API key under Developers, open the TieTalent plugin in Pinpoint under Settings, Integrations, My Plugins, paste the TieTalent API key, optionally add your Pinpoint account URL and a Pinpoint API key with only Application read access, then run Candidate Intelligence or Role Fit from an application or a Stage Action.
What you need
- Pinpoint Company Manager access (Integrations and API & Webhooks)
- TieTalent workspace owner, admin or developer (Developers → API keys)
- About 10 minutes, with Pinpoint and TieTalent open in two tabs
- Keep API keys secret. Treat the TieTalent key as a one-time copy when you create it
Five steps to connect
- 1
Create a TieTalent API key
TieTalent → Developers → API keys → Create
In TieTalent, open Developers → API keys and create a key. Copy the full value once (it starts with ats_). TieTalent will not show the full secret again.
- 2
Open TieTalent in Pinpoint
Pinpoint → Settings → Integrations → My Plugins → TieTalent → Configure
In Pinpoint, open Settings → Integrations → My Plugins. Find TieTalent and open Configure. You should see fields for the TieTalent API key plus optional Pinpoint account URL and Pinpoint API key.
- 3
Paste the TieTalent API key
Pinpoint → TieTalent Configure → TieTalent API key → Save
Paste the ats_ key into TieTalent API key and save. Without a valid key, the action form shows a setup warning.
- 4
Add Pinpoint account access (recommended)
Pinpoint → Settings → API & Webhooks → API Keys → then TieTalent Configure
In Pinpoint Settings → API & Webhooks, enable the Pinpoint API, then create an API key with only Application: Read. TieTalent only reads through this key and never changes anything in Pinpoint. Back in TieTalent Configure, paste your account URL (https://yourcompany.pinpointhq.com) and that API key. This lets TieTalent read LinkedIn, CV, work history and the job description, so Role Fit can run from a Stage Action without pasting a job description.
- 5
Run Candidate Intelligence or Role Fit
Pinpoint → Application → ⋯ → Run TieTalent …, or Stage → Add stage action
On a candidate application, open the ⋯ menu and choose Run TieTalent Candidate Intelligence or Run TieTalent Role Fit. Or add a Stage Action on a pipeline stage so the report starts automatically when candidates enter that stage. Role Fit without the Pinpoint connection needs a pasted job description.
Confirm the connection with one candidate
Pick a real application with a CV when possible. Start Candidate Intelligence or Role Fit. Role Fit needs a job description on the form or from your connected Pinpoint job. When the run finishes, the assessment on the application shows a verdict or fit summary, key facts, and an Open TieTalent report link. That confirms the connection works.
What “done” looks like
- Pinpoint My Plugins → TieTalent is configured with a valid TieTalent API key
- At least one assessment started and returned results on the Pinpoint application
- Optional Pinpoint API connection filled if you want automatic LinkedIn, CV and job description enrichment
Common issues
Setup warning about the TieTalent API key
Create a fresh key under TieTalent Developers → API keys, paste the full ats_ value into Pinpoint Configure, and save. Revoked or mistyped keys are rejected.
Invalid Pinpoint account URL or API key pairing
Use your sign-in address, for example https://yourcompany.pinpointhq.com. If you add the URL, you must also add the Pinpoint API key (or remove both). Create the key under Settings → API & Webhooks with only Application: Read.
Role Fit asks for a job description
Without the optional Pinpoint connection, paste the job description into the form. With the connection configured, leave it empty so TieTalent can read the job from Pinpoint.
Not enough credits or Candidate Intelligence not switched on
Every run uses credits from your TieTalent workspace. If there aren't enough, the run doesn't start and nothing is charged; a TieTalent admin can top up under Plans & billing. If Candidate Intelligence isn't switched on for your workspace, contact TieTalent to have it switched on.
Assessment starts but results do not appear in Pinpoint
Reports take a few minutes. Refresh the application. If a run fails, the assessment shows the reason and no credits are charged. Every run also appears in TieTalent History under Candidate Intelligence or Role Fit, where you can filter by Pinpoint.
TieTalent can't read the candidate from Pinpoint
The assessment says Pinpoint rejected the API key. The Pinpoint API key was revoked or doesn't have Application: Read. Create a new key with Application: Read, paste it into TieTalent Configure and run the report again.
Running it again returns the same report
If the same candidate is run again with the same details (CV, LinkedIn profile and, for Role Fit, job description) within 6 months, TieTalent returns the existing report at no charge. Change the details, for example upload a newer CV, to get a new report.
Ready to connect?
Create a TieTalent API key, then configure TieTalent in Pinpoint My Plugins. Talk to us if your team needs a walkthrough.