Implemented

HR, recruitment & payroll

Teamtailor

Read and write Teamtailor jobs, candidates, job applications, notes, locations, departments and custom field values; read stages, interviews, scorecards and offers.

Move candidates between the ATS, HRIS and CRM, keep job ads and hiring pipelines in sync, and report on interviews and offers.

Build a flow with Teamtailor Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

candidates

Create candidate
Destination
Not retried automatically
Approval before production
Creates a candidate; set merge to update an existing candidate with the same email.
candidates.create
Get candidate
Source
One candidate by ID.
candidates.get
List candidates
Source
Incremental
Candidates with contact details, tags and consent timestamps.
candidates.list
Update candidate
Destination
Provider duplicate protection
Approval before production
Updates a candidate's contact details, tags or consent.
candidates.update

custom field values

Set custom field value
Destination
Not retried automatically
Approval before production
Creates a custom field value on a candidate or job.
custom_field_values.create
List custom field values
Source
Typed custom field values on candidates and jobs.
custom_field_values.list
Update custom field value
Destination
Provider duplicate protection
Approval before production
Changes an existing custom field value.
custom_field_values.update

custom fields

List custom fields
Source
Custom field definitions with API name and type.
custom_fields.list

departments

Create department
Destination
Not retried automatically
Approval before production
Creates a department.
departments.create
List departments
Source
Departments used on jobs and candidates.
departments.list
Rename department
Destination
Provider duplicate protection
Approval before production
Renames a department.
departments.update

interviews

List interviews
Source
Interview kits filled in by interviewers.
interviews.list

job applications

Create job application
Destination
Not retried automatically
Approval before production
Applies a candidate to a job.
job_applications.create
Get job application
Source
One job application by ID.
job_applications.get
List job applications
Source
Incremental
Applications with candidate, job, stage and rejection details.
job_applications.list
Update job application
Destination
Provider duplicate protection
Approval before production
Moves an application to a stage, or updates its cover letter.
job_applications.update

job offers

List job offers
Source
Offers with status, approval status and response.
job_offers.list

jobs

Create job
Destination
Not retried automatically
Approval before production
Creates a job ad with a recruiter.
jobs.create
Get job
Source
One job ad by ID.
jobs.get
List jobs
Source
Incremental
Job ads with status, salary, remote status and recruiter.
jobs.list
Update job
Destination
Provider duplicate protection
Approval before production
Updates a job ad's attributes, status, recruiter or department.
jobs.update

locations

Create location
Destination
Not retried automatically
Approval before production
Creates an office location (city and country required).
locations.create
List locations
Source
Incremental
Office locations with address and coordinates.
locations.list
Update location
Destination
Provider duplicate protection
Approval before production
Updates an office location.
locations.update

notes

Create note
Destination
Not retried automatically
Approval before production
Adds a comment to a candidate as a Teamtailor user.
notes.create
List notes
Source
Candidate comments and reviews (notes with a rating).
notes.list

requisitions

List requisitions
Source
Headcount requisitions with openings and salary range.
requisitions.list

scorecard scores

List scorecard scores
Source
Scores given per scorecard criterion in interviews.
scorecard_scores.list

stages

List stages
Source
Pipeline stages with type, order and application counts.
stages.list

users

List users
Source
Recruiters, hiring managers and other Teamtailor users.
users.list

Authentication

Teamtailor API key (Admin scope, read/write)

Plans and access

All Teamtailor plans with API access; candidate data requires an Admin-scoped API key. Public and Internal keys only see jobs, departments and locations. Candidates, applications, notes, users and custom fields need an Admin key; writes need the write or read/write permission.

Test environment

Teamtailor provides test companies to partners on request.

Rate limits

50 requests per 10 seconds; HTTP 429 with X-Rate-Limit-Reset when exceeded.

Pagination

JSON:API cursor paging with page[size] (max 30) and page[after] taken from links.next.

Provider events

Teamtailor webhooks for candidate, job application and job events. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

Requests pin X-Api-Version 20240904, which the changelog requires since 2025-10-01; older examples in the docs still show 20240404.
Relationship IDs (candidate, job, stage, user) are returned for job applications, stages and notes through `include`; other lists return relationship links only.
Moving an application to another stage or rejecting it writes the `stage` and `reject-reason` relationships; the docs only show a cover-letter update, so stage moves are not verified against a live account.
Interviews, scorecard scores, job offers and requisitions are read only. Resume files are not downloaded (signed URLs expire after 30 seconds).
Deletes are not implemented. Teamtailor has no idempotency key, so uncertain creates are not repeated.

Developer reference

Create the Teamtailor AB credentials described above with the narrowest permissions your flows need.
In Nexra, open Connect, then Connections, then New connection, choose Teamtailor, enter its settings and credentials, and tick only the write actions you need. Connection guide
Test the connection, then use its actions as flow sources and destinations. Flow guide

Teamtailor AB docsAPI reference Teamtailor AB docsAuthentication

Machine-readable detail: GET /api/public/connect/connectors/teamtailor and the Connections API.