Connect TieTalent to

Two keys, five steps. After setup, recruiters start Candidate Intelligence or Role Fit from Ashby interview stages and see results on the candidate timeline.
Video transcript
This walkthrough shows how to create an Ashby API key with TieTalent as the partner, paste it into TieTalent Settings under Integrations, copy the TieTalent inbound key once, paste it into Ashby Admin under Integrations for TieTalent, enable the integration, then add Candidate Intelligence or Role Fit on an interview stage and start one assessment.
What you need
- Ashby admin access (API keys and Admin → Integrations)
- TieTalent workspace admin or owner (Settings → Integrations)
- About 10 minutes, with Ashby and TieTalent open in two tabs
- Both keys stay secret. Treat the TieTalent inbound key as one-time copy
Five steps to connect
- 1
Create an Ashby API key
Ashby → Admin → Integrations → API Keys → Create (partner: TieTalent)
In Ashby, create an API key with partner set to TieTalent. Enable these scopes: apiKeys:read, candidates:read, candidates:write, and jobs:read. Copy the key once. Ashby will not show it again.
- 2
Paste the Ashby key in TieTalent
TieTalent → Settings → Integrations → Ashby → Validate
Open TieTalent Settings → Integrations → Ashby. Paste the Ashby API key and click Validate. TieTalent checks each required scope and shows Connected when validation succeeds.
- 3
Copy the TieTalent inbound key
TieTalent → Settings → Integrations → Ashby → Inbound key
After a successful validate, TieTalent shows an inbound key (starts with tti_). Copy it immediately and store it securely. You only see the full value once.
- 4
Paste the inbound key in Ashby
Ashby → Admin → Integrations → TieTalent → Enable
In Ashby Admin → Integrations, open TieTalent, paste the inbound key, and enable the integration so Ashby can call TieTalent Assessments.
- 5
Add assessments on interview stages
Ashby → Job → Interview plan → Add assessment → Start on a candidate
On a job’s interview plan, add Candidate Intelligence and/or Role Fit on the stages where recruiters should run them. Start one assessment from a candidate application to confirm the loop works.
Confirm the connection with one candidate
Pick a real application with a job posting. Start Candidate Intelligence or Role Fit from the stage you configured. Role Fit needs a job with a description. When the run finishes, the report should appear on the Ashby candidate timeline. That means both keys and Assessments are working.
What “done” looks like
- TieTalent Settings → Ashby shows Connected with all scopes green
- Ashby Admin → Integrations → TieTalent is enabled
- At least one assessment started and results returned to Ashby
Common issues
Invalid or rejected Ashby API key
Regenerate the key in Ashby with partner TieTalent. Paste the new value into TieTalent and Validate again. Do not reuse a key created for another partner.
Missing scopes after Validate
Edit the Ashby key (or create a new one) so it includes apiKeys:read, candidates:read, candidates:write, and jobs:read. Validate again until every scope passes.
Lost the TieTalent inbound key
The full inbound key is shown only once. Disconnect Ashby in TieTalent Settings, reconnect with a fresh Ashby key, copy the new inbound key, and update Ashby Admin → Integrations → TieTalent.
Role Fit fails or asks for a job description
Role Fit reads the Ashby job posting. Ensure the application is tied to a job with a description, then start Role Fit again.
Assessment starts but results do not appear in Ashby
Confirm TieTalent is enabled under Ashby Integrations, the inbound key matches the connected workspace, and the assessment type is Candidate Intelligence or Role Fit on the interview stage. Check TieTalent for a completed run, then refresh the candidate in Ashby.
Ready to connect?
Open TieTalent settings to validate your Ashby key, or talk to us if your team needs a walkthrough.