Connect Breezy HR

Request checks from Breezy HR stages and get each check's status back in the candidate's stream. Reports stay in PreHireBadge.

Updated 6 of 17 in API, MCP and integrations

Works with Breezy HR. When a candidate reaches a stage you choose, PreHireBadge creates a check request in Ready to send. A person on your team confirms and sends it. When the check is complete, Breezy HR gets a status note in the candidate's stream. Reports, results, and AI summaries stay in PreHireBadge.

Who it is for. An owner or admin who uses Breezy HR to manage candidates and wants check requests to start from the hiring pipeline without switching tools.

How to connect

  1. Get a Breezy API token. Breezy issues tokens through its sign-in API, done once by an account owner. See Breezy's API overview for the steps.
  2. In PreHireBadge, open Settings, then Integrations, find Breezy HR, and choose Connect. Paste the token and accept the integration certification. If your Breezy account has more than one company, also paste the company ID.
  3. Pick the stages that should request a check, your default work location, and the default pay band.
The Breezy HR setup page, where you choose the stages that request a check.
The Breezy HR setup page, where you choose the stages that request a check.

What Breezy HR receives

PreHireBadge posts a status note in the candidate's stream. It looks like this:

PreHireBadge background check: Clear. Updated Nov 10, 2026. Check 0B6F2B1E. Sign in to view: …

Breezy HR never receives the report, results, AI summaries, or resumes. Hired and Disqualified are Breezy's built-in stages; PreHireBadge reads them to run the adverse action watchdog.

Instant updates and the five-minute check

When a check finishes, PreHireBadge posts the status note to Breezy HR right away. A background check also runs every five minutes and picks up any changes the instant update may have missed.

A person sends every check

The stage trigger does not order a check and does not use a credit. Open Ready to send, under Screening, confirm the permissible purpose, and send it there.

When something fails

Settings, then Integrations, lists each connected app. The Activity card shows recent requests. Each error includes a short fix. Common problems:

  • The hiring tool did not accept the saved key. The token may have expired. Create a new one in Breezy, then Disconnect and connect again with the new key.
  • The key can see more than one company in the hiring tool. Paste the company ID from this guide, then Disconnect and connect again.
  • The hiring tool refused a request. A stage you chose may have been renamed or removed in Breezy HR. Reselect the stages in the Setup section on the integration page.

Disconnect there to stop the integration. Requests already waiting in Ready to send can still be dismissed.

See Integrations and the FCRA and adverse action watchdog for more on how connected hiring tools work with PreHireBadge.

Was this article helpful?