AI agents for Teamtailor

Find candidates

Lists candidates (JSON:API), optionally the one with an email address or phone, in a city or country, or created or changed after a time.

Get a candidate

Reads one candidate with their job applications included.

List a candidate's applications

Lists a candidate's job applications with their stage and job included.

List job applications

Lists job applications across jobs, optionally only those in a stage type (Inbox, In process, Hired), changed stage or created in a time range, sorted.

Get a job application

Reads one job application with its candidate, job and stage included.

List jobs

Lists jobs of a status (published by default; unlisted, archived, draft, scheduled or all — internal ones need an Internal or Admin key), optionally in a department or location.

Get a job

Reads one job.

List a job's stages

Lists the pipeline stages of a job in board order.

List users

Lists the company's Teamtailor users (recruiters, hiring managers), optionally the one with an email address.

Create a candidate

Adds a candidate with first and last name and email (unique unless sourced), and optionally phone, pitch, tags and a public resume URL Teamtailor downloads.

Apply a candidate to a job

Creates a job application linking an existing candidate to a job, optionally as sourced and with a cover letter; the hiring team is notified unless turned off.

Move an application to a stage

Moves a job application to another stage of its job (stage IDs from "List a job's stages") by updating its stage relationship.

Add a note to a candidate

Adds a comment to a candidate, optionally linked to one job application and attributed to a user (an ID from "List users").