Teamtailor
Bring new starters, changes and leavers from Teamtailor into every system that needs them, with HR approving each change.
51 ways to read, 27 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Teamtailor, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create candidate
candidates.createApproval by rule - Create custom field option
custom_field_options.createApproval by rule - List candidates
candidates.listRead
Example flow
- Teamtailor · List candidates
candidates.listDone - Teamtailor · Create candidate
candidates.createMaker-checker - Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Teamtailor.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Teamtailor
- Teamtailor's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Read and write Teamtailor jobs, candidates, applications, notes, stages, teams, to-dos, reject reasons, locations, departments, regions and custom fields; read interviews, scorecards and referrals.
Teamtailor AB API docs- Source actions
- 51
- Destination actions
- 27
- Data types
- 29
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
candidates4
- Create candidateDestinationNot retried automaticallyApproval before production
Creates a candidate; set merge to update an existing candidate with the same email.
- Get candidateSource
One candidate by ID.
- List candidatesSourceIncremental
Candidates with contact details, tags and consent timestamps.
- Update candidateDestinationProvider duplicate protectionApproval before production
Updates a candidate's contact details, tags or consent.
company1
- Get companySource
The Teamtailor company the API key belongs to.
custom field options3
- Create custom field optionDestinationNot retried automaticallyApproval before production
Adds an option to a select or multi-select custom field.
- List custom field optionsSource
Options of select and multi-select custom fields.
- Update custom field optionDestinationProvider duplicate protectionApproval before production
Renames a custom field option.
custom field values4
- Set custom field valueDestinationNot retried automaticallyApproval before production
Creates a custom field value on a candidate or job.
- Get custom field valueSource
One typed custom field value.
- List custom field valuesSource
Typed custom field values on candidates and jobs.
- Update custom field valueDestinationProvider duplicate protectionApproval before production
Changes an existing custom field value.
custom fields4
- Create custom fieldDestinationNot retried automaticallyApproval before production
Creates a custom field definition for candidates or jobs.
- Get custom fieldSource
One custom field definition.
- List custom fieldsSource
Custom field definitions with API name and type.
- Rename custom fieldDestinationProvider duplicate protectionApproval before production
Renames a custom field definition.
departments4
- Create departmentDestinationNot retried automaticallyApproval before production
Creates a department.
- Get departmentSource
One department by ID.
- List departmentsSource
Departments used on jobs and candidates.
- Rename departmentDestinationProvider duplicate protectionApproval before production
Renames a department.
divisions2
- Get divisionSource
One division.
- List divisionsSource
Divisions (brands or business units) that group departments.
interviews2
- Get interviewSource
One interview kit filled in by an interviewer.
- List interviewsSource
Interview kits filled in by interviewers.
job applications4
- Create job applicationDestinationNot retried automaticallyApproval before production
Applies a candidate to a job.
- Get job applicationSource
One job application by ID.
- List job applicationsSourceIncremental
Applications with candidate, job, stage and rejection details.
- Update job applicationDestinationProvider duplicate protectionApproval before production
Moves an application to a stage, or updates its cover letter.
job offers1
- List job offersSource
Offers with status, approval status and response.
jobs4
- Create jobDestinationNot retried automaticallyApproval before production
Creates a job ad with a recruiter.
- Get jobSource
One job ad by ID.
- List jobsSourceIncremental
Job ads with status, salary, remote status and recruiter.
- Update jobDestinationProvider duplicate protectionApproval before production
Updates a job ad's attributes, status, recruiter or department.
locations4
- Create locationDestinationNot retried automaticallyApproval before production
Creates an office location (city and country required).
- Get locationSource
One office location by ID.
- List locationsSourceIncremental
Office locations with address and coordinates.
- Update locationDestinationProvider duplicate protectionApproval before production
Updates an office location.
notes4
- Create noteDestinationNot retried automaticallyApproval before production
Adds a comment to a candidate as a Teamtailor user.
- Get noteSource
One candidate comment or review.
- List notesSource
Candidate comments and reviews (notes with a rating).
- Update noteDestinationProvider duplicate protectionApproval before production
Changes the text of a candidate comment.
nps responses1
- List candidate NPS responsesSource
Candidate experience scores and feedback.
referrals2
- Get referralSource
One employee referral.
- List referralsSource
Employee referrals with the referred person and referrer.
regions3
- Create regionDestinationNot retried automaticallyApproval before production
Creates a region.
- Get regionSource
One region.
- List regionsSource
Regions that group locations.
reject reasons4
- Create reject reasonDestinationNot retried automaticallyApproval before production
Adds a reject reason to the account's list. Rejects no application.
- Get reject reasonSource
One reject reason.
- List reject reasonsSource
Reasons used when an application is rejected or withdrawn.
- Update reject reasonDestinationProvider duplicate protectionApproval before production
Renames a reject reason or changes who it is attributed to.
requisitions1
- List requisitionsSource
Headcount requisitions with openings and salary range.
roles2
- Get roleSource
One role.
- List rolesSource
Roles used to group jobs within departments.
scorecard criteria2
- Get scorecard criterionSource
One scorecard criterion.
- List scorecard criteriaSource
Skills and traits candidates are scored on.
scorecard picks1
- List scorecard picksSource
Criteria picked for jobs' scorecards.
scorecard scores2
- Get scorecard scoreSource
One score given for a scorecard criterion.
- List scorecard scoresSource
Scores given per scorecard criterion in interviews.
stage types2
- Get stage typeSource
One stage category.
- List stage typesSource
Stage categories: inbox, screening, interview, offer and hired.
stages3
- Create stageDestinationNot retried automaticallyApproval before production
Adds a pipeline stage to a job.
- Get stageSource
One pipeline stage.
- List stagesSource
Pipeline stages with type, order and application counts.
team memberships3
- Add team memberDestinationNot retried automaticallyApproval before production
Adds a user to a team, or to a job's hiring team.
- Get team membershipSource
One team or hiring-team membership.
- List team membershipsSource
Users on teams and on jobs' hiring teams.
teams4
- Create teamDestinationNot retried automaticallyApproval before production
Creates a team with a lead user.
- Get teamSource
One team.
- List teamsSource
Teams of users with their lead.
- Update teamDestinationProvider duplicate protectionApproval before production
Renames a team or changes its emoji.
todos4
- Create to-doDestinationNot retried automaticallyApproval before production
Creates a recruiter to-do, optionally about a candidate.
- Get to-doSource
One recruiter to-do.
- List to-dosSource
Recruiter to-dos with due date, assignee and candidate.
- Update to-doDestinationProvider duplicate protectionApproval before production
Changes a to-do's text or due date.
triggers1
- List triggersSource
Stage automations (smart schedule, messages, tags and others). Read only.
users2
- Get userSource
One Teamtailor user by ID.
- List usersSource
Recruiters, hiring managers and other Teamtailor users.
Access and limits
- 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. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Relationship IDs (candidate, job, stage, user) are returned for job applications, stages and notes through `include`; other lists return relationship links only.
- 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.
- Not implemented on purpose: candidate messages and emails, rejecting applications, job offer writes, user creation (sends an invitation email), requisition writes, company updates, notification settings, uploads, and every delete.
- Some collections (regions, teams, to-dos, reject reasons, stage types and others) link the next page with page[number] instead of page[after]; Nexra follows either.
- regions.get is documented with a referral example response; the region shape is taken from the list and create examples.
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
Machine-readable detail: GET /api/public/connect/connectors/teamtailor and the Connections API.