Integrate Breezy HR to streamline your recruiting and applicant tracking processes.
Integrate Breezy HR to streamline your recruiting and applicant tracking processes. On Nagent, Breezy Hr is exposed as a fully-configurable hr talent & recruitment integration that any agent can call — 48 actions, and None authentication. No code is required to wire Breezy Hr into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Breezy Hr 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 Breezy Hr 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 Breezy Hr, with input parameters and output schema. Drop these into any step of an agent built in Helix.
BREEZY_HR_ADD_CANDIDATE_CUSTOM_ATTRIBUTEAdd or update a custom attribute for a candidate in Breezy HR. Use when you need to store custom metadata, internal notes, evaluation scores, or any other custom data for a candidate application. If the attribute name already exists for this candidate, its value will be updated with the new value.
Input parameters
The name/key of the custom attribute.
The value to assign to the custom attribute.
Whether this value needs to be encrypted at rest. Defaults to false.
The unique identifier of the company in Breezy HR.
The unique identifier of the position (job posting).
The 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
BREEZY_HR_ADD_CANDIDATE_DOCUMENTUpload a document file for an existing candidate in Breezy HR. Use when you need to attach additional documents (cover letters, portfolios, certifications, or other files) to a candidate's application. The file is sent as multipart/form-data with the field name 'data'. This action is idempotent - uploading a document with the same name may create a duplicate or update the existing document depending on Breezy HR behavior.
Input parameters
The document file to upload. FileUploadable object where 'name' should be the filename (e.g., 'resume.pdf', 'cover_letter.docx', 'certificate.png'). This will be sent as multipart form field named 'data'.
The unique identifier of the company in Breezy HR.
The unique identifier of the position (job posting).
The 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
BREEZY_HR_ADD_CANDIDATE_EDUCATIONAdd an education entry to an existing candidate in Breezy HR. Use this action when you need to record a candidate's educational background, such as degrees, certifications, or school attendance. If an education entry already exists for the same school, it will be updated with the provided values.
Input parameters
The year the education ended (or expected end year if still studying).
The unique identifier of the company in Breezy HR.
The year the education started.
The unique identifier of the position (job posting).
The name of the educational institution.
The unique identifier of the candidate.
The field of study or major.
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
BREEZY_HR_ADD_CANDIDATE_NOTEAdds a note to a candidate's discussion stream in Breezy HR. Use this action when you need to record observations, interview feedback, or any communication about a candidate directly in their profile. The note becomes part of the candidate's activity history and is visible to all users with access to the candidate.
Input parameters
The content of the note to add to the candidate's discussion stream. This will appear in the candidate's activity feed.
The unique identifier for the company. Found in the Breezy HR dashboard URL or company settings.
The unique identifier for the job position. Found in the position URL or position details page.
The unique identifier for the candidate. Found in the candidate profile URL or candidate list.
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
BREEZY_HR_ADD_CANDIDATE_RESUMEAttach a resume file to an existing candidate in Breezy HR. Use when you need to add or update a candidate's resume document. The file is sent as multipart/form-data with the field name 'file'.
Input parameters
The resume file to upload. FileUploadable object where 'name' should be the filename (e.g., 'resume.pdf', 'john_doe_cv.pdf').
The unique identifier of the company. This can be found in the company details or URL.
The unique identifier of the position. This can be found in the position details or URL.
The unique identifier of the candidate. This can be found in the candidate details or URL.
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
BREEZY_HR_ADD_CANDIDATE_WORK_HISTORYAdd a work history entry to an existing candidate in Breezy HR. Use this action when you need to record a candidate's employment history, such as previous job positions, companies, and work responsibilities. If a work history entry already exists for the same company, it will be updated with the provided values.
Input parameters
The job title or role at the company.
A description of the work performed or accomplishments.
The year when the work ended. Set to the current year if still employed.
The month when the work ended (1-12). Set to the current month if still employed.
The unique identifier of the company in Breezy HR.
The year when the work started.
The unique identifier of the position (job posting).
The month when the work started (1-12).
The unique identifier of the candidate.
The name of the company where the candidate worked.
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
BREEZY_HR_CREATE_CANDIDATEAdd a new candidate to a position in Breezy HR. Use when you need to create or add a candidate to a specific job position. This action allows you to programmatically add candidates to positions with various details including contact information, education, work history, social profiles, and custom attributes. The candidate can be marked as 'sourced' (direct hire) or 'applied' (applicant tracking). Note: If origin is 'applied', email_address is required. For 'sourced' candidates, email is optional but recommended.
Input parameters
Full name of the candidate
Tags/labels to associate with the candidate
Origin type for the candidate.
Custom source to attribute to the incoming candidate
Physical address of the candidate
Professional summary or bio
Educational background of the candidate
Unique identifier for the company. Found in Breezy HR settings or URL.
Unique identifier for the position/job. Found in Breezy HR or URL.
Cover letter or personal statement
Phone number of the candidate
Work history of the candidate
Email address of the candidate. Required when origin is 'applied'.
Social media profiles for the candidate.
Custom key-value attributes for the candidate. The secure flag determines if values are encrypted at rest.
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
BREEZY_HR_CREATE_CANDIDATE_FROM_RESUMEUpload and parse a resume file to create a new candidate in Breezy HR. Use this action when you need to add a new job candidate by uploading their resume. The resume is parsed and candidate information is automatically extracted and associated with the specified position. The candidate will be placed in the default 'applied' stage unless a different stage_id is specified.
Input parameters
Resume file to upload. FileUploadable object where 'name' should be the filename (e.g., 'resume.pdf', 'john_doe_resume.docx'). The file content will be parsed to extract candidate information.
ID of the pipeline stage to place the new candidate in. Defaults to 'applied' if not specified.
The unique identifier of the company in Breezy HR.
The unique identifier of the position to attach the candidate to.
Whether to execute stage actions configured for the stage where the candidate is being created. Defaults to false.
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
BREEZY_HR_CREATE_POSITIONCreate a new position in Breezy HR. Use when you need to add a new job opening to your company's hiring pipeline with specific details like title, description, location, and employment type. This action creates a position that can then accept applications from candidates. The position will be created in draft state by default unless otherwise specified.
Input parameters
The name/title of the position.
Tags to associate with the position for organization and filtering.
The type of employment for this position.
Category classification for the position.
The location details for the position. Must include at least country.
Education level required for the position.
The unique identifier of the company in Breezy HR.
The department this position belongs to.
Experience level required for the position.
The detailed description of the position including responsibilities and requirements.
The ID of the pipeline to use for this position. Defaults to 'default'.
The ID of a scorecard template to use for candidate evaluation.
An internal requisition reference ID.
Configuration for application form field visibility.
The ID of a questionnaire to attach to the position.
Custom attributes to attach to the position. Secure attributes are encrypted at rest.
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
BREEZY_HR_CREATE_WEBHOOK_ENDPOINTCreate a new webhook endpoint to receive event notifications from Breezy HR. Use this action when you need to set up real-time notifications for events such as candidates being added, deleted, or having their status updated. The response includes a secret key that should be stored securely to verify incoming webhook signatures. This action is idempotent based on the endpoint URL and subscribed events.
Input parameters
The URL that will receive webhook notifications when subscribed events occur.
List of event types to subscribe to. The endpoint will receive notifications for these events.
The unique identifier of the company in Breezy HR.
An optional description to help identify the webhook endpoint.
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
BREEZY_HR_DELETE_WEBHOOK_ENDPOINTDelete an existing webhook endpoint from Breezy HR. Use this action when you need to remove a webhook endpoint that is no longer needed for receiving real-time notifications about Breezy HR events such as candidate additions, deletions, or status updates. This action is irreversible — the webhook endpoint cannot be recovered once deleted.
Input parameters
The unique identifier of the company in Breezy HR.
The unique identifier of the webhook endpoint 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
BREEZY_HR_GET_CANDIDATERetrieve candidate details by ID for a given position in Breezy HR. Use this action when you need to fetch the full profile and details of a specific candidate applying to a specific job position. This includes contact information, social accounts, recruitment stage, rating, source, and other candidate metadata. This is a read-only operation that does not modify any candidate data.
Input parameters
The unique identifier of the company.
The unique identifier of the position/job posting.
The 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
BREEZY_HR_GET_CANDIDATE_CONVERSATIONRetrieve the conversation stream for a specific candidate applying to a position. Use when you need to view all messages exchanged with a candidate, including messages sent by the hiring team and responses from the candidate. The conversation includes timestamps, message content, attachments, and sender information.
Input parameters
Number of records to skip for paging
Unique identifier of the company
Unique identifier of the position
Unique identifier of the candidate
Set to 1 to include any messages that are currently queued for delayed delivery
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
BREEZY_HR_GET_CANDIDATE_METARetrieves candidate meta data by ID for a given position. Use this action when you need to fetch all metadata information (assessments, documents, scorecards, etc.) associated with a specific candidate for a specific job position. The metadata includes various aspects of the candidate's interaction and evaluation such as assessments, background checks, conversation history, documents, questionnaires, references, schedule, scorecards, stream activity, tasks, and team notes.
Input parameters
The unique identifier of the company.
The unique identifier of the position/job posting.
The 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
BREEZY_HR_GET_CANDIDATE_RESUMERetrieve a candidate's resume file from a specific job position in Breezy HR. Use this action when you need to download and review a candidate's resume/CV for a specific job application. The resume is typically returned as a PDF or Word document. This action streams the resume file directly from Breezy HR's servers.
Input parameters
The unique identifier of the company in Breezy HR.
The unique identifier of the position (job posting).
The 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
BREEZY_HR_GET_CANDIDATE_STREAMRetrieves the last 50 candidate discussion stream events by candidate ID for a given position. Use this action when you need to view the conversation history, activity timeline, status changes, or all interactions related to a specific candidate within a job position. This is useful for tracking candidate engagement, reviewing hiring team notes, or monitoring the progression through the pipeline.
Input parameters
The unique identifier for the company. Found in Breezy HR dashboard URL or company settings.
The unique identifier for the job position. Found in the position URL in Breezy HR.
The unique identifier for the candidate. Found in the candidate profile URL.
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
BREEZY_HR_GET_COMPANYRetrieves complete information about a company in Breezy HR. Use when you need to fetch company details, settings, or profile information for a specific Breezy HR company account.
Input parameters
The unique identifier of the company. Found in your Breezy HR dashboard URL.
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
BREEZY_HR_GET_PIPELINERetrieves pipeline stages by pipeline ID for a specified company. Use when you need to fetch the hiring workflow stages associated with a particular pipeline, including stage names, icons, action counts, and associated actions.
Input parameters
The unique identifier of the company. Found in your Breezy HR dashboard URL.
The unique identifier of the pipeline 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
BREEZY_HR_GET_POSITIONRetrieves detailed information about a specific job position by its ID. Use this action when you have a company ID and position ID and need to fetch the complete position details including description, location, requirements, and settings.
Input parameters
The unique identifier of the company. This is the company ID from Breezy HR.
The unique identifier of the position 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
BREEZY_HR_GET_POSITION_TEAMRetrieves user objects of all team members assigned to a specific job position. Use this action when you need to view the hiring team members associated with a particular position, including their names, email addresses, usernames, roles (Hiring Team Member or Hiring Manager), and account details. This is useful for understanding who has access to and responsibility for a specific job posting in your Breezy HR account.
Input parameters
The unique identifier for the company. Found in your Breezy HR dashboard URL.
The unique identifier for the job position. Found in the position URL in Breezy HR.
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
BREEZY_HR_GET_QUESTIONNAIRERetrieves a questionnaire by its ID for a specific company. Use this action when you need to fetch the details, questions, and settings of an existing questionnaire in Breezy HR.
Input parameters
The unique identifier of the company. Found in your Breezy HR dashboard URL or company settings.
The unique identifier of the questionnaire 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
BREEZY_HR_GET_TEMPLATERetrieves an email template by its ID for a specific company. Use this action when you need to fetch the details, subject line, body content, and settings of an existing email template in Breezy HR.
Input parameters
The unique identifier of the company. Found in your Breezy HR dashboard URL or company settings.
The unique identifier of the template 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
BREEZY_HR_GET_USERRetrieves information about the authenticated user or a specific user by ID. Use this action when you need to fetch user profile details, including name, email, role, and other account information from Breezy HR. If user_id is not provided, the action returns the currently authenticated user's information.
Input parameters
The unique identifier of the user to retrieve. If not provided, returns the authenticated user.
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
BREEZY_HR_GET_USER_DETAILSRetrieves the details for the configurations of each company the authenticated user belongs to. This includes company information, hiring pipelines, questionnaires, templates, tasks, scorecards, and team member data. Use this action when you need to fetch comprehensive user and company configuration data for the authenticated user across all accessible companies.
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
BREEZY_HR_GET_WEBHOOK_ENDPOINTRetrieves detailed information about a specific webhook endpoint by its ID. Use this action when you need to fetch details about an existing webhook endpoint, including its configuration, subscribed events, status, and delivery statistics. This is a read-only operation that does not modify any data.
Input parameters
The unique identifier of the company in Breezy HR.
The unique identifier of the webhook endpoint 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
BREEZY_HR_LIST_CANDIDATE_ASSESSMENTSRetrieves all 3rd party assessments a candidate has taken for a specific position. Use this action when you need to: - View the assessment history for a specific candidate - Check the status of ongoing or pending assessments - Retrieve assessment results and reports - Verify candidate has completed required pre-employment assessments This action queries the Breezy HR API to get all assessments associated with a candidate within a specific position and company context.
Input parameters
The unique identifier of the company.
The unique identifier of the position.
The 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
BREEZY_HR_LIST_CANDIDATE_BACKGROUND_CHECKSRetrieves all 3rd party background checks for a candidate. Use this action when you need to: - View the background check history for a specific candidate - Check the status of ongoing background checks - Retrieve background check results and reports This action queries the Breezy HR API to get all background checks associated with a candidate within a specific position and company context.
Input parameters
The unique identifier of the company.
The unique identifier of the position.
The 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
BREEZY_HR_LIST_CANDIDATE_CUSTOM_ATTRIBUTESRetrieves all candidate-specific custom attributes configured for a company. Use this action when you need to list all available custom fields that can be used to store additional candidate information beyond the standard Breezy HR candidate fields. These custom attributes can include things like desired salary, source of application, department preferences, or any other company-specific data points. This is a read-only operation that does not modify any data.
Input parameters
The unique identifier of the company. This is a required path parameter.
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
BREEZY_HR_LIST_CANDIDATE_CUSTOM_FIELDSRetrieves all custom field values for a specific candidate in the context of a job position. Use when you need to get the values of custom fields that have been filled out for a candidate in a specific job application, such as source of application, desired salary, department preference, or any other company-defined custom data points. This is a read-only operation that does not modify any data.
Input parameters
The unique identifier of the company.
The unique identifier of the position/job posting.
The 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
BREEZY_HR_LIST_CANDIDATE_DOCUMENTSRetrieve candidate documents by candidate ID for a given position. Use when you need to list all documents associated with a specific candidate for a specific job position. The documents may include resumes, cover letters, portfolios, or other relevant files.
Input parameters
The unique identifier for the company.
The unique identifier for the position.
The unique identifier for 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
BREEZY_HR_LIST_CANDIDATE_QUESTIONNAIRESRetrieves all questionnaires for a specific candidate. Use this action when you need to: - View all questionnaires associated with a candidate - Check the status of questionnaire submissions - Retrieve questionnaire completion dates and scores - Track pending or overdue questionnaires This action queries the Breezy HR API to get all questionnaires associated with a candidate within a specific position and company context.
Input parameters
The unique identifier of the company.
The unique identifier of the position.
The 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
BREEZY_HR_LIST_COMPANIESRetrieve the companies associated with the authenticated user. Use this action when you need to discover what companies are accessible to the authenticated user, such as for listing available workspaces or checking company 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
BREEZY_HR_LIST_PIPELINESRetrieve all pipelines for a company. Use this action when you need to list all hiring pipelines configured in a Breezy HR company account. This action is read-only and returns pipeline information including stages, positions, and settings.
Input parameters
The unique identifier of 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
BREEZY_HR_LIST_POSITION_CUSTOM_ATTRIBUTESRetrieve all position-specific custom attributes defined for a company in Breezy HR. Use this action when you need to discover what custom fields are available for job positions, such as for building forms, validating attribute values, or understanding position data structure.
Input parameters
The unique identifier of the company. This is the company ID from Breezy HR.
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
BREEZY_HR_LIST_POSITION_CUSTOM_FIELDSRetrieve all custom fields for a specific position in Breezy HR. Use this action when you need to fetch the custom field values assigned to a particular job position, such as when reviewing candidate applications or updating position details. This action retrieves the custom field values (name, value, and security flag) that are associated with the specified position.
Input parameters
The unique identifier of the company in Breezy HR.
The unique identifier of the position/job posting.
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
BREEZY_HR_LIST_POSITIONSRetrieves all job positions for a specified company, optionally filtered by state. Use when you need to find available job openings, list company positions, or get position details for a Breezy HR company account. The state filter defaults to 'published' to return only active job listings.
Input parameters
Valid values for position state filter.
The unique identifier of the company. Found in your Breezy HR dashboard URL.
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
BREEZY_HR_LIST_QUESTIONNAIRESRetrieves all company questionnaires from Breezy HR. Use this action when you need to fetch all available questionnaires associated with a specific company in the Breezy HR system.
Input parameters
The unique identifier of 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
BREEZY_HR_LIST_TEMPLATESRetrieves all company email templates from Breezy HR. Use this action when you need to fetch all available email templates associated with a specific company in the Breezy HR system. This is useful for finding templates to use in candidate communications, customizing email workflows, or managing company communication templates.
Input parameters
The unique identifier of the company. Found in your Breezy HR dashboard URL.
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
BREEZY_HR_LIST_WEBHOOK_ENDPOINTSRetrieves all webhook endpoints configured for a specified company in Breezy HR. Use when you need to list all registered webhook endpoints, audit which events are being monitored, or check the configuration of existing webhooks. This action is read-only and idempotent.
Input parameters
The unique identifier of the company in Breezy HR.
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
BREEZY_HR_PAUSE_WEBHOOK_ENDPOINTPause webhook delivery to an endpoint in Breezy HR. Use when you need to temporarily stop receiving webhook notifications without deleting the endpoint configuration. The endpoint remains configured and can be resumed later. This action is useful during maintenance windows, debugging scenarios, or when you need to temporarily halt webhook processing while keeping the endpoint configuration intact. The endpoint status changes to 'paused' while the 'enabled' flag remains true, allowing for easy resumption.
Input parameters
The unique identifier of the company in Breezy HR.
The unique identifier of the webhook endpoint to pause.
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
BREEZY_HR_RESUME_WEBHOOK_ENDPOINTResume webhook delivery to a paused endpoint in Breezy HR. Use when you need to resume webhook delivery to an endpoint that was previously paused. Once resumed, the endpoint will start receiving webhook notifications for subscribed events again.
Input parameters
The unique identifier of the company in Breezy HR.
The unique identifier of the webhook endpoint to resume.
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
BREEZY_HR_SEARCH_CANDIDATESSearch for candidates by their email address across all positions in a company. Use when you need to find candidates with a specific email address, verify if a candidate exists in the system, or retrieve candidate information based on email. This is a read-only operation that searches across all positions and pipelines.
Input parameters
The unique identifier of the company. Found in your Breezy HR dashboard URL.
The email address to search for candidates. Must be a valid email format.
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
BREEZY_HR_UPDATE_CANDIDATETool to update a candidate on a specific position in Breezy HR. Use when you need to modify candidate information such as their headline, contact details, social profiles, tags, or other details on an existing candidate application. The candidate must already exist for the specified position. This action makes a PUT request to update the candidate's information.
Input parameters
Full name of the candidate
Array of tags to organize or categorize the candidate
Custom source to attribute to the incoming candidate
Physical address of the candidate
Summary or biography of the candidate
Professional headline or title for the candidate
Unique identifier for the company
Unique identifier for the position
Unique identifier for the candidate
Cover letter or introduction text
Phone number of the candidate
Email address of the candidate
Social media profile URLs for 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
BREEZY_HR_UPDATE_CANDIDATE_SCORECARDUpdate a candidate's scorecard for a specific position in a company. Use this action when you need to record a candidate's evaluation score and optional notes during the hiring process. This action is idempotent — calling it multiple times with the same parameters will update (not duplicate) the scorecard.
Input parameters
An optional note to add with the score.
The score code for the candidate scorecard. One of: very_poor, poor, neutral, good, very_good.
The unique identifier of the company.
The unique identifier of the position (job).
The 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
BREEZY_HR_UPDATE_CANDIDATE_STAGEMove a candidate to a specified stage in the hiring pipeline. Use when you need to advance, move, or reassign a candidate to a different stage in the recruitment process (e.g., from 'applied' to 'interviewing', or 'interviewing' to 'offer'). The action requires the company ID, position ID, candidate ID, and the target stage ID.
Input parameters
The ID of the Pipeline stage to put the candidate in. Common stage values include: hired, disqualified, offer, feedback, interviewing, applied.
The unique identifier for the company.
The unique identifier for the position (job opening).
The unique identifier for 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
BREEZY_HR_UPDATE_POSITIONTool to update details of an existing position in Breezy HR. Use when you need to modify any attributes of an existing job position such as the name, description, department, employment type, category, education requirements, experience level, location, tags, or other position properties. The position must already exist for the specified company. This action makes a PUT request to update the position's information.
Input parameters
The name or title of the position
Array of tags to organize or categorize the position
Enumeration of position types.
Enumeration of position categories.
Location object for a position.
Enumeration of education levels for positions.
The unique identifier of the company. This can be found in the company details or URL.
The department this position belongs to
Enumeration of experience levels for positions.
Detailed description of the position and responsibilities
ID of the hiring pipeline to use for this position
The unique identifier of the position to update. This can be found in the position details or URL.
ID of the scorecard template to use for evaluating candidates
External requisition tracking ID
Application form field settings.
ID of the screening questionnaire to attach to this position
Custom attributes for the position. Secure attributes are encrypted at rest.
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
BREEZY_HR_UPDATE_POSITION_STATEUpdate the state of an existing position in Breezy HR. Use when you need to change a position's workflow state (e.g., from draft to published, or closing a position after hiring is complete). This action is commonly used during recruitment workflow management.
Input parameters
The new state for the position. Valid values are: draft, published, closed, archived.
The unique identifier of the company. This can be found in the company details or URL.
The unique identifier of the position to update. This can be found in the position details or URL.
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
BREEZY_HR_UPDATE_WEBHOOK_ENDPOINTUpdate an existing webhook endpoint to receive event notifications from Breezy HR. Use when you need to modify the configuration of an existing webhook endpoint, such as changing the target URL, updating the description, modifying subscribed events, or enabling/disabling the endpoint. The endpoint must already exist for the specified company. This action makes a PUT request to update the webhook endpoint's configuration.
Input parameters
The HTTPS URL that will receive webhook notifications when subscribed events occur.
List of event types to subscribe to. The endpoint will receive notifications for these events.
Whether the webhook endpoint is enabled. Set to false to temporarily disable webhook deliveries.
The unique identifier of the company in Breezy HR.
An optional description to help identify the webhook endpoint.
The unique identifier of the webhook endpoint to update.
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 98 agents privately built on Nagent that already use Breezy Hr.
Build on Nagent
Connect Breezy Hr 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 Breezy Hr, and click "Connect Now." You'll authenticate with None — Nagent handles credential storage and refresh automatically. Once connected, Breezy Hr is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Breezy Hr is connected, you configure its 48 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Breezy Hr 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 Breezy Hr event fires, the agent kicks off automatically.
Every Breezy Hr 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 Breezy Hr ships with 48 pre-built hr talent & recruitment actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Breezy Hr together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Breezy Hr-based workflows tailored to your business.