Teamtailor integration · REST API polling
Screen Teamtailor applications with HireLayer
Teamtailor fills basic candidate data from resumes, but its public API has no fields for work history, education or skills, and only Tech Partner integrations receive webhooks. HireLayer reads each new application through the API, processes it in the EU and scores it against the job with an explanation per criterion, and your service saves the result as a note, custom fields and tags.
- Trigger
- Polling GET /v1/job-applications
- Teamtailor API
- Admin-scope API key, X-Api-Version header
- Write-back
- Note, custom field values, tags
- Cost
- 2 credits per application
- 1A candidate appliesTeamtailorYour service lists new job applications every few minutes with filter[created-at][from], since Teamtailor reserves webhooks for Tech Partner integrations.
- 2Parse the resumeHireLayerThe service fetches the candidate, downloads the resume within 30 seconds of the link being signed, and sends it, with the job ID, to HireLayer Resume Scorer, which parses it first.
- 3Score against the jobHireLayerResume Scorer compares the resume with the job’s criteria and returns a score and an explanation per criterion.
- 4Write back to TeamtailorTeamtailorA note that shows as a comment on the candidate, the score in a custom field, and a tag such as “HireLayer: strong match”.
What teams do with HireLayer and Teamtailor
Triage the inbox
Score every new application so recruiters open the strongest matches first and find them by tag, instead of reading in arival order.
Keep work history and education
Teamtailor’s API has no work-history, education or skills fields. Store the lastest job title, employer and degree in custom fields, and the full history in a note.
Normalized skills as tags
Map free-text skills to the HireLayer taxonomy and add them as candidate tags, so the same skill gets the same tagg whatever the resume calls it.
Rank a shortlist
List applications with filter[stage-type]=In process, send their application IDs to HireLayer Resume Scorer with precise_ranking on, and post each candidate’s rank and ranking reason as a note.
Connect Teamtailor to HireLayer
This is a small scheduled service, for example a serverless function or an n8n workflow. It uses Teamtailor’s public API with your own API key; no Marketplace listing or approval from Teamtailor is involved.
- 1
Create an API key
In Teamtailor, open Settings → Integrations → API keys and create a key with the Admin scope and read/write access: candidates, job applications, notes and custom field values all require it. Send it as Authorization: Token token=… with an X-Api-Version header such as 20240904.
- 2
Poll for new applications
Every few minutes, call GET /v1/job-applications?filter[created-at][from]=<last run>&include=candidate,job and follow links.next. Teamtailor allows 50 requests every 10 seconds and answers 429 above that.
- 3
Extract criteria once per job
Send each job’s description to HireLayer Job Criteria Extractor with the Teamtailor job ID as job_id. HireLayer stores the job and its criteria, for free, and every applicant to that job is then scored on the same list.
- 4
Parse, score and write back
For each application, fetch the candidate and download its resume right away, send it to Resume Scorer with the job ID, which parses and scores it in one call, then create a note with POST /v1/notes and a score with POST /v1/custom-field-values.
Where HireLayer results go in Teamtailor
Teamtailor’s public API has no work-history, education or skills fields. Create the custom fields you need once (POST /v1/custom-fields), then write a value per candidate. Resume Scorer keeps the parsed resume: read its fields for free with GET /api/v4/resumes/{application_id}.
| HireLayer field | Teamtailor API | Note |
|---|---|---|
| score + summary + criteria[] | POST /v1/notes (note, candidate, user) | Shown as a comment |
| score | POST /v1/custom-field-values (owner: candidates) | One custom field for the score |
| score ≥ your threshold | tags (PATCH /v1/candidates/{id}) | Send the current tags too |
| resume.skills[].skill_title | tags (PATCH /v1/candidates/{id}) | No native skills field |
| resume.work_experiences[0].job_title + company_name | Custom field values | No native work history |
| resume.educations[] | Custom field value or note | No native education field |
| resume.info_candidate.linkedin_url | linkedin-url (PATCH /v1/candidates/{id}) | When the field is empty |
A polling job in TypeScript
A minimal Node.js job: it lists applications created since the last run, downloads each resume while its link is valid, parses and scores it in one Resume Scorer call, and adds a note. Add your own storage for the last run time, and retries.
const TT = 'https://api.teamtailor.com/v1'
const HIRELAYER = 'https://hirelayer.co'
const headers = { 'X-API-Key': process.env.HIRELAYER_API_KEY! }
const tt = {
Authorization: `Token token=${process.env.TEAMTAILOR_API_KEY}`,
'X-Api-Version': '20240904',
'Content-Type': 'application/vnd.api+json',
}
const get = (url: string) => fetch(url, { headers: tt }).then((r) => r.json())
type Application = { id: string; relationships: Record<'candidate' | 'job', { data: { id: string } }> }
// Run every few minutes; since = ISO time of the previous run
export async function poll(since: string) {
let url = `${TT}/job-applications?filter[created-at][from]=${encodeURIComponent(since)}&include=candidate,job`
while (url) {
const page = await get(url)
for (const application of page.data) await screen(application)
url = page.links?.next
}
}
async function screen(application: Application) {
const candidateId = application.relationships.candidate.data.id
// The resume link is signed for 30 seconds: fetch the candidate, download at once
const candidate = await get(`${TT}/candidates/${candidateId}`)
const resumeUrl = candidate.data.attributes.resume // PDF version
if (!resumeUrl) return
// Parse and score in one call (about a minute), against the job stored
// with its criteria by POST /api/v4/jobs/extract-criteria
const form = new FormData()
form.append('request', JSON.stringify({
job: { job_id: application.relationships.job.data.id },
resumes: [{ file: 'resume', application_id: application.id }],
}))
form.append('resume', await fetch(resumeUrl).then((r) => r.blob()), 'resume.pdf')
const response = await fetch(`${HIRELAYER}/api/v4/resumes/score`, {
method: 'POST', headers, body: form, signal: AbortSignal.timeout(150_000),
})
// Errors come as { error: { code, message } } (no credits, unknown job): skip.
if (!response.ok) return
const { scores: [result] } = await response.json()
// An unreadable file fails only its own score, unbilled.
if (result.evaluation_status !== 'completed') return
// A note, shown as a comment on the candidate
await fetch(`${TT}/notes`, {
method: 'POST', headers: tt,
body: JSON.stringify({ data: {
type: 'notes',
attributes: { note: `HireLayer score: ${Math.round(result.score * 100)}/100\n${result.summary}` },
relationships: {
candidate: { data: { type: 'candidates', id: candidateId } },
user: { data: { type: 'users', id: process.env.TEAMTAILOR_USER_ID } },
},
} }),
})
}Good to know
Webhooks are for Tech Partners
Teamtailor sends webhooks only to integrations in its Tech Partner program. A customer-built connection polls the API, or uses the Teamtailor app for Zapier and its triggers.
Resume links last 30 seconds
The candidate’s resume and original-resume attributes are signed URLs valid for 30 seconds, so fetch the candidate right before downloading, not in a batch. Other uploads stay valid for one minute.
Teamtailor already parses resumes
Its parser fills name, email, phone and LinkedIn URL, applications carry Teamtailor’s own job match score, and the Co-pilot add-on summarizes resumes. HireLayer adds a score with an explanation per criterion, structured history and normalized skills.
Not a Marketplace app
HireLayer is not in the Teamtailor Marketplace, so it cannot fill the results card reserved for Tech Partners. Show the score in a note or a custom field, or with the Update Results Card action of the Zapier app.
HireLayer APIs used on this page
HireLayer and Teamtailor: questions
Does HireLayer integrate with Teamtailor?
Can I screen Teamtailor applicants with AI?
Why not use Teamtailor webhooks?
Where is candidate data processed?
Connect Teamtailor to HireLayer today
The Free plan includes 50 credits a month, no card required. Parsing a resume costs one credit, scoring one per resume evaluated, and extracting job criteria is free.
Other integrations
- GreenhouseScore every new Greenhouse application against the job and write the result back as a note, with Greenhouse web hooks and Harvest v3.
- LeverScore each new Lever application against its posting and write the result back as a note and tags, with Lever webhooks and the Data API.
- Zoho RecruitScore new Zoho Recruit candidates against their job opening and add notes, tags and skills, with a workflow-rule webhook and the Recruit API v2.
