n8n-nodes-breezy-hr

This is an n8n community node. It lets you use Breezy HR in your n8n workflows.

Breezy HR is a recruiting and applicant tracking system (ATS) for managing candidates, positions, and hiring pipelines.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

This package ships two nodes.

Breezy HR (action node)

• Company
  • Get — retrieve a single company
  • Get Many — list the companies you can access
• Position
  • Create, Get, Get Many, Update
  • Set State — publish, draft, archive, or close a position
• Candidate
  • Create, Get, Get Many, Update
  • Set Stage — move a candidate to a different pipeline stage
  • Move — move a candidate to another position and stage
  • Add Note — add an internal team note
  • Download Resume — download the candidate's resume as binary data

Company, position, candidate, and stage fields are dropdowns that load live from your Breezy account — pick a company and the position list narrows to it, pick a position and the candidate/stage lists narrow to it.

Breezy HR Trigger

Starts a workflow when events happen in Breezy. Auto-registers and cleans up its webhook with Breezy on activation/deactivation, and verifies each delivery's HMAC-SHA256 signature. Supported events:

• Candidate: Added, Deleted, Status Updated
• Position: Added, Updated, Deleted, State Updated
• Note: Posted, Updated, Deleted

Breezy only accepts public HTTPS webhook URLs, so the trigger cannot register against http://localhost. When self-hosting locally, expose n8n with a tunnel (e.g. Cloudflare Tunnel or ngrok) and set WEBHOOK_URL accordingly.

Credentials

Authentication uses a Breezy Personal Access Token (PAT).

1. Sign in to Breezy and open your account settings.
2. Create a Personal Access Token (it starts with breezy_pat_).
3. In n8n, create a Breezy HR API credential and paste the token.

n8n validates the token against Breezy's /v3/user endpoint when you save the credential. See the Breezy authentication docs for details.

Compatibility

Tested against n8n 2.x. Requires n8n 1.60.0 or later.

Usage

A common pattern: use the Breezy HR Trigger with Candidate Status Updated to start a workflow whenever a candidate changes stage, then branch on the new stage to send a Slack message, kick off onboarding, or update another system. To attach a resume to those downstream steps, follow the trigger with a Breezy HR → Candidate → Download Resume node and wire its binary output into an upload or email node.

Resources

• n8n community nodes documentation
• Breezy HR API documentation