Teamtailor

Retrieve a specific activity record by its unique identifier. Activities represent actions performed within the recruitm…

Retrieve all activities associated with a specific candidate. This returns a chronological feed of actions and events re…

Retrieve all activities associated with a specific job posting. This returns a chronological feed of actions and events…

Retrieve all activities performed by a specific user in the recruitment system. This returns a chronological feed of act…

Retrieve candidate responses to application questions. IMPORTANT - You must use filter_question parameter to avoid timeo…

Retrieve a specific answer by its unique identifier. Returns the complete response including the answer content and meta…

Create a new answer for a candidate’s response to an application question. Requires candidate_id from list_candidates, q…

Retrieve a time-limited authenticated URL for accessing video answer content. The returned URL is valid for 2 hours and…

Retrieve a paginated list of all candidates in the recruitment system. Candidates are individuals who have applied for p…

Retrieve complete information about a specific candidate using their unique identifier. Returns the full candidate profi…

Add a new candidate to the recruitment system with their profile information. Conditional requirement - either email is…

Modify an existing candidate’s profile information. Use this to update contact details, correct information, or add addi…

Permanently remove a candidate and all their associated data from the system. This action cannot be undone and should be…

Retrieve the organization’s company profile and account settings. Returns core company information including company nam…

Update the organization’s company profile settings. Allows modifying company name and website. Can also update the manag…

Retrieve custom field values for specific candidates or jobs.

Retrieve a specific custom field value by its unique identifier. Obtain the ID from list_custom_field_values action.

Set a custom field value for a candidate. Requires custom_field_id from list_custom_fields (must be a Candidate owner-ty…

Modify an existing custom field value. Requires id from list_custom_field_values or create_custom_field_value.

Retrieve all custom field definitions configured in the system. Custom fields extend the standard candidate and job data…

Retrieve a specific custom field definition by its unique identifier. Requires id obtained from list_custom_fields.

Create a new custom field definition for candidates or jobs.

Update an existing custom field definition. Requires id from list_custom_fields. Note that api-name cannot be changed af…

Retrieve a specific select-type custom field by its unique identifier. Returns the complete field configuration includin…

Create a new select-type custom field definition. Allows creating single-select or multi-select fields with predefined o…

Update an existing select-type custom field definition. Allows modifying the name or API name of an existing select or m…

Retrieve all available options for select-type custom fields. Options are the individual choices that appear in dropdown…

Retrieve a specific custom field option by its unique identifier. Returns the option’s value and the custom field it bel…

Create a new option for a select-type custom field. Adds a new choice to the dropdown menu of an existing single-select…

Update an existing custom field option. Allows modifying the display value of a dropdown choice.

Retrieve all divisions configured in the organization. Divisions represent the highest level of organizational hierarchy…

Retrieve detailed information about a specific division by its unique identifier. Returns the division name and related…

Retrieve a paginated list of all departments in the organization. Departments are used to categorize jobs and organize t…

Retrieve complete information about a specific department using its unique identifier. Returns the department name, asso…

Add a new department to the organizational structure. Departments are used to categorize jobs and appear as filters on t…

Modify an existing department’s information, such as renaming it. Useful for organizational restructuring or keeping dep…

Permanently remove a department from the organizational structure. Before deleting, ensure no jobs are assigned to this…

Retrieve all forms configured in the organization. Forms are customizable questionnaires used to collect structured info…

Retrieve detailed information about a specific form by its unique identifier. Returns the form configuration, title, and…

Retrieve all questions used across forms. Questions define what information is collected from candidates, including the…

Retrieve a specific form question by its unique identifier. Returns the complete question configuration including text,…

Retrieve candidate responses to form questions. Answers contain the actual data submitted by candidates when completing…

Retrieve a specific form answer by its unique identifier. Returns the complete response including the question asked and…

Retrieve all scheduled interviews across the organization. Interviews are meetings arranged between candidates and team…

Retrieve detailed information about a specific interview by its unique identifier. Returns the complete interview record…

Retrieve a paginated list of all job postings in the system. Jobs represent open positions that candidates can apply for…

Retrieve complete information about a specific job posting using its unique identifier. Returns the full job details inc…

Create a new job posting in the recruitment system. The job can be created as a draft for review or published immediatel…

Modify an existing job posting. Use this to update job details, change the status, or edit the description. Commonly use…

Permanently remove a job posting and all its associated data from the system. This action cannot be undone. Consider arc…

Retrieve a paginated list of all job applications in the system. Job applications represent candidates who have applied…

Retrieve complete information about a specific job application using its unique identifier. Returns the full application…

Submit a new job application connecting a candidate to a specific job position. This creates the link between a candidat…

Modify a job application to update the cover letter. Requires Admin scope with write permissions.

Retrieve all employment offers that have been extended to candidates. Job offers track the formal offer process includin…

Retrieve detailed information about a specific job offer by its unique identifier. Returns the complete offer record inc…

Retrieve a paginated list of all office locations in the organization. Locations represent physical offices or work site…

Retrieve complete information about a specific location using its unique identifier. Returns the full address details, g…

Add a new office location to the organization. Locations are used to categorize jobs geographically and appear as filter…

Modify an existing location’s information such as its name or address details. Useful when office addresses change or na…

Permanently remove a location from the organization. Before deleting, ensure no jobs are assigned to this location or re…

Retrieve a paginated list of all notes and comments recorded on candidates and their job applications. Notes capture rec…

Retrieve the complete content of a specific note using its unique identifier. Returns the full note text, information ab…

Add a new note or comment to a candidate’s profile. Use this to record interview feedback, document observations, or sha…

Add a new note or comment to a specific job application. Use this when the feedback is specific to one application rathe…

Modify the content of an existing note. Use this to correct information, add additional details, or update feedback afte…

Permanently remove a note from a candidate or job application. Use this to delete outdated information, remove inappropr…

Retrieve all onboarding records for hired candidates. Onboardings track the new hire process from offer acceptance throu…

Retrieve detailed information about a specific onboarding record by its unique identifier. Returns the complete onboardi…

Retrieve the mapping of questions to specific jobs. Picked questions represent which questions from the library have bee…

Retrieve all questions from the organization’s question library. Questions are reusable across multiple job postings and…

Retrieve all configured rejection reasons available in the system. Rejection reasons provide standardized explanations f…

Retrieve a specific rejection reason by ID.

Add a new rejection reason option.

Modify an existing rejection reason. Requires reject reason id from list_reject_reasons.

Remove a rejection reason option. Requires reject reason id from list_reject_reasons.

Retrieve all job requisitions and their approval status. Requisitions are formal requests to fill a position, often requ…

Retrieve detailed information about a specific requisition by its unique identifier. Returns the complete requisition in…

Submit a new job requisition for approval. This initiates the hiring approval workflow, requesting permission to fill a…

Modify an existing requisition’s details such as title, headcount, or reason. Requires requisition id from list_requisit…

Retrieve all job role categories configured in the organization. Roles classify jobs by function or area of expertise su…

Retrieve a specific role by its unique identifier. Returns the role name and configuration.

Create a new job role category in the organization. Roles classify jobs by function or area of expertise such as Enginee…

Delete a job role category from the organization. Requires role id from list_roles.

Retrieve all hiring pipeline stages across jobs. Stages represent the steps candidates progress through during recruitme…

Retrieve complete information about a specific hiring stage using its unique identifier. Returns the stage name, type, p…

Add a new stage to a job’s hiring pipeline. Use this to customize the recruitment workflow with additional steps like te…

Retrieve all available stage type definitions that categorize stages in the hiring pipeline. Stage types include Inbox f…

Retrieve a specific stage type by its unique identifier. Returns the stage type name and configuration.

Retrieve all teams configured in the organization. Teams group users together for permission management and collaborativ…

Retrieve detailed information about a specific team by ID.

Add a new team for organizing users and managing access. Requires user_id from list_users as the team manager.

Update an existing team’s information. Requires team id from list_teams.

Remove a team from the organization. Requires team id from list_teams.

Retrieve team membership records showing user-team associations.

Retrieve details of a specific team membership by ID.

Add a user to a team. Requires user_id from list_users and team_id from list_teams.

Remove a user from a team. Requires membership id from list_team_memberships.

Retrieve a paginated list of all users in the system. Users include recruiters, hiring managers, administrators, and oth…

Retrieve complete information about a specific user using their unique identifier. Returns the user’s profile details, r…

Add a new team member to the Teamtailor system. Use this to onboard new recruiters, create hiring manager accounts, or s…

Modify an existing user’s profile information, role, or visibility settings. Use this to update names, change permission…

Remove a user account from the system. Before deleting, reassign any jobs owned by this user to another team member. Thi…

Retrieve all file uploads attached to candidates. Uploads include resumes, cover letters, portfolios, and other document…

Retrieve a specific upload by ID.

Attach a file to a candidate profile using a public URL. Requires candidate_id from list_candidates.