Recruitee is a collaborative hiring software that streamlines recruitment processes, enabling teams to source, interview, and hire candidates efficiently.
Recruitee is a collaborative hiring software that streamlines recruitment processes, enabling teams to source, interview, and hire candidates efficiently. On Nagent, Recruitee is exposed as a fully-configurable hr talent & recruitment integration that any agent can call — 23 actions, and API_KEY, OAUTH2 authentication. No code is required to wire Recruitee into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Recruitee to automate the kinds of tasks hr talent & recruitment teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Recruitee into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Recruitee, with input parameters and output schema. Drop these into any step of an agent built in Helix.
RECRUITEE_CREATE_CANDIDATETool to create a new candidate profile. Use after gathering all candidate details. Example: "Create a new candidate named Jane Doe with email jane.doe@example.com."
Input parameters
Full name of the candidate.
List of tags associated with the candidate.
Email address of the candidate
Phone number of the candidate.
URL to the candidate's photo
List of offer IDs to associate with the candidate.
URL to the candidate's resume
The source from which the candidate was obtained.
Cover letter text for the candidate.
List of social media profile links for the candidate.
Custom fields for the candidate as defined by the company.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_CREATE_NOTECreates a new note for a candidate in Recruitee. Notes can be used to record interview feedback, assessments, or any observations about the candidate. Use this when you need to add commentary or documentation to a candidate's profile.
Input parameters
The note object containing content and optional visibility.
Unique identifier of the candidate to attach the note to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_CREATE_OFFERCreates a new job offer or talent pool in Recruitee. Required fields include title, location IDs, and description. Use Get Locations action to retrieve valid location IDs before creating an offer. The offer status can be set to draft, internal, published, closed, or archived.
Input parameters
The offer object containing details for the new job offer.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_DELETE_CANDIDATETool to delete a candidate profile. Use when you need to permanently remove a candidate from your Recruitee account. Returns no content on success.
Input parameters
Unique identifier of the candidate to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_DELETE_TAGPermanently deletes a tag from Recruitee by its ID. This action requires appropriate API permissions to delete tags. Use this when you need to remove unused or obsolete tags. Note: Deleting a tag removes it from all associated candidates and offers.
Input parameters
The unique numeric identifier of the tag to delete. Must be a positive integer.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_CANDIDATETool to retrieve detailed information about a specific candidate. Use when you need the candidate's full profile before proceeding.
Input parameters
Company ID or subdomain. Can be either the numerical company ID or the company subdomain. If not provided, uses the subdomain from the connection.
Unique identifier of the candidate to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_CANDIDATESTool to retrieve a list of all candidates in the company. Use when you need to fetch or filter candidates before proceeding.
Input parameters
List of candidate IDs to retrieve.
Sort by date or by last message.
Maximum number of candidates to return.
Search term to filter candidates by name or offer.
Number of candidates to skip before returning results (pagination offset).
If true, only deleted candidates are returned.
Filter candidates by specific offer ID.
If true, only qualified candidates are returned.
Company ID or subdomain. Can be either the numerical company ID or the company subdomain. If not provided, uses the subdomain from the connection.
Return candidates created after this ISO 8601 timestamp.
If true, only disqualified candidates are returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_COMPANY_IDTool to retrieve the company ID of the authenticated account. Use when you need to confirm your company identity before other operations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_COMPANY_OFFER_PUBLICTool to retrieve a specific published job offer by ID or slug from the public Careers Site API. Use after you have the offer identifier.
Input parameters
Offer ID or slug, e.g., '12345' or 'software-engineer'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_DEPARTMENTSTool to retrieve a list of company departments. Use when you need to reference or assign offers or candidates to departments.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_LOCATIONSTool to retrieve a list of company locations. Use when you need to see all location options before assigning them to offers.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_NOTESTool to retrieve a list of notes for a specific candidate. Use after confirming the candidate exists when you need to review their notes.
Input parameters
Maximum number of notes to return per page.
Number of notes to skip.
Unique identifier of the candidate.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_OFFERSTool to retrieve a list of all job offers. Use after authentication to browse or paginate your company's complete set of offers.
Input parameters
Maximum number of offers to return (1-100).
Search term to filter job offers.
Number of offers to skip (for pagination).
Company ID or subdomain. Can be either the numerical company ID or the company subdomain. If not provided, uses the subdomain from the connection.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_PIPELINE_STAGESTool to retrieve pipeline stages of a job offer. Use when you have the offer ID and need its stages to track candidate progression. Example: "Get pipeline stages for offer ID 456."
Input parameters
ID of the job offer to retrieve pipeline stages for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_GET_TAGSRetrieve all tags with optional filtering and pagination. Search by name, sort by name or usage count, and paginate through results.
Input parameters
Page number of results (minimum 1).
Search term to filter tags by name.
Field to sort by: 'name' or 'taggings_count'.
Number of tags per page (1-100).
Sort order: 'asc' or 'desc'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_LIST_EEO_JOB_CATEGORIESTool to retrieve available EEO (Equal Employment Opportunity) job categories. Use when you need to see standard EEO job classification options.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_LIST_INVOICESTool to list invoices for a company. Use to retrieve billing invoice records.
Input parameters
Company ID or subdomain. Can be either the numerical company ID or the company subdomain. If not provided, uses the subdomain from the connection.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_LIST_LOCALIZATION_SETTINGSTool to retrieve localization settings including proposed time format and start day of the week. Use when you need to check regional or time display preferences.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_LIST_SHARE_COUNTRIESTool to retrieve all countries with region codes and phone codes per locale. Use when you need comprehensive country reference data including internationalization details.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_LIST_SHARE_EEO_ANSWERSTool to retrieve available EEO (Equal Employment Opportunity) answers. Use when you need to see available answer options for EEO compliance questions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_UPDATE_CANDIDATEUpdates an existing candidate's information in Recruitee. Use this to modify candidate details such as name, contact info, cover letter, tags, and social links. All fields except candidate_id are optional - only provide the fields you want to update. The API performs a partial update (PATCH), preserving any fields you don't specify.
Input parameters
Full name of the candidate.
List of tags associated with the candidate.
Primary email address of the candidate. Note: The Recruitee API stores emails as an array, so this field may not update the candidate's email list as expected.
Primary phone number of the candidate. Note: The Recruitee API stores phones as an array, so this field may not update the candidate's phone list as expected.
URL to the candidate's photo.
List of offer IDs to associate with the candidate.
URL to the candidate's resume.
Source from which the candidate was obtained. Must be a valid source defined in the Recruitee system. Common values include 'manual', 'career_site', etc. Invalid sources will result in a 422 error.
Unique identifier of the candidate to update.
Cover letter text for the candidate.
List of social media profile links for the candidate.
Custom fields for the candidate as defined by the company.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_UPDATE_NOTETool to update an existing note for a candidate. Use when you need to modify note text or pin status after creation.
Input parameters
Updated text content of the note.
True to pin the note, false to unpin.
Unique identifier of the note to update.
Unique identifier of the candidate.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RECRUITEE_UPDATE_OFFERUpdates an existing job offer or talent pool in Recruitee. Allows modification of offer details including title, description, requirements, status, locations, department assignment, work type (remote/hybrid/on-site), visibility settings, and application form field requirements. Only specified fields are updated; omitted fields remain unchanged. Requires the offer ID - use Get Offers or Get Offer actions to retrieve existing offer IDs.
Input parameters
Type of the offer: 'job' for standard job postings or 'talent_pool' for talent pools.
The title of the job offer.
Display the job as hybrid (combination of on-site and remote) on the careers site.
Display the job as fully remote on the careers site.
Current status of the offer. Options: 'draft' (not visible), 'internal' (visible to team), 'published' (public), 'closed' (no longer accepting applications), 'archived' (hidden from all views).
Display the job as on-site on the careers site.
The unique identifier of the offer to update. Required.
CV/resume upload field setting in application form. Options: 'required' (must upload), 'optional' (can upload), 'off' (field hidden).
Detailed description of the job offer. Supports HTML formatting.
List of location IDs for the job offer. Use Get Locations action to retrieve valid IDs.
Job requirements and qualifications. Supports HTML formatting.
Department ID to assign the offer to. Use Get Departments action to retrieve valid IDs.
Phone number field setting in application form. Options: 'required' (must provide), 'optional' (can provide), 'off' (field hidden).
Photo upload field setting in application form. Options: 'required' (must upload), 'optional' (can upload), 'off' (field hidden).
Custom question text for the location picker in the application form. Only used when 'locations_question' is in visibility_options.
Job visibility and feature options. Include 'indeed' to post on Indeed, 'linkedin' for LinkedIn, 'social_share' for social media sharing, 'job_location' to show location, 'locations_question' to enable location picker in application form.
Cover letter field setting in application form. Options: 'required' (must provide), 'optional' (can provide), 'off' (field hidden).
Type of location selection in application form: 'single_choice' allows one location, 'multiple_choice' allows multiple.
Whether applicants must answer the location question to submit their application.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 82 agents privately built on Nagent that already use Recruitee.
Build on Nagent
Connect Recruitee to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Recruitee, and click "Connect Now." You'll authenticate with API_KEY, OAUTH2 — Nagent handles credential storage and refresh automatically. Once connected, Recruitee is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Recruitee is connected, you configure its 23 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Recruitee steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Recruitee event fires, the agent kicks off automatically.
Every Recruitee action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Recruitee ships with 23 pre-built hr talent & recruitment actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Recruitee together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Recruitee-based workflows tailored to your business.