Recruiting & ATS · Integration
Breezy HR
Add Breezy HR to your product for your customers, and give your AI agents governed access to it.
Breezy HR's API is at api.breezy.hr/v3, and there is no long-lived API key to paste: you POST credentials to /signin and receive an access_token that is then sent on every subsequent call, so any integration has to store and refresh a session rather than a static secret. Almost every resource is nested under a company, following the shape /company/{company_id}/position/{position_id}/candidates, which means a client must resolve the company id first and cannot address a candidate by id alone. Malformed or unauthenticated requests come back as 400 rather than 401, so status codes are a weak signal for credential problems and the body has to be read. Candidates carry a stage that maps to the position's own pipeline, and pipelines are configured per position, so stage names are tenant-specific and cannot be hard-coded; the same applies to custom questionnaire answers attached to an application. Candidate origin distinguishes sourced from applied, which matters for any reporting on channel effectiveness. fastn holds each customer's Breezy session, refreshes it before it lapses, and keeps the nested routing details out of your code.
In your product
Embedded for your customers. Per-tenant auth, no per-customer code, maintained by fastn.
Let a customer connect their own Breezy HR account and pick which positions flow into your product
Push a sourced candidate into the right position and pipeline stage from your sourcing tool
Read questionnaire answers per application so your scoring model works on the customer's own fields
Report time in stage per position using the tenant's own pipeline names rather than generic ones
For your AI agents
Governed, audited access for the agents you build, through the MCP server.
Let an agent move a candidate to the next stage only after a recruiter approves the change
Have an agent summarise new applications for one position, with every read audited per tenant
Let an agent flag candidates sitting in a stage longer than the customer's agreed threshold
Example prompt
Who applied for the senior backend role this week and which stage are they in?
Set up Breezy HR in 4 steps
- 01Enable the Breezy HR connector from your fastn dashboard.
- 02Have each customer authorise their own Breezy HR account, so calls run under their credentials rather than a shared key.
- 03Decide which job requisitions, candidates and applications your product needs, map those fields, then enable the actions and triggers you want.
- 04Call it from your product and expose it to your agents through the same governed connection.
Why teams use the Breezy HR integration
What you get by embedding it with fastn instead of building it yourself.
- Ship a Breezy HR integration without building it. Your customers connect their own Breezy HR account inside your product and work their job requisitions, candidates and applications there, with no per-customer code on your side.
- Handle the part that actually costs time: candidate records are personal data with consent and retention rules attached. fastn owns the auth, token refresh, rate limits, pagination and breaking-change fixes, so a Breezy HR update is not your on-call problem.
- One integration serves your product and your agents. The same governed Breezy HR connection powers in-product features and gives AI agents scoped, audited access, so you keep hiring pipelines moving without manual re-entry without wiring it twice.
Used by these teams
Compare with
Greenhouse
Ashby
LeverOften used alongside
Tools the same teams tend to run next to Breezy HR, across other categories.
Slack
Notion
Box
DocusignBreezy HR integration FAQ
How do I add a Breezy HR integration to my product?
Enable the Breezy HR connector in your fastn dashboard, then let each customer authenticate their own Breezy HR account. fastn handles the OAuth flow, token storage and refresh per tenant, so there is no Breezy HR client code in your app and no per-customer branch in your codebase. Setup is 4 steps.
Do my customers each connect their own Breezy HR account?
Yes. Every connection is scoped to the individual customer, so each authorises their own Breezy HR account and only ever sees their own job requisitions, candidates and applications. That per-tenant isolation is the point of an embedded integration: you support the long tail of customer setups without maintaining an integration per customer.
Can AI agents use this Breezy HR integration?
Yes. The same connection is exposed to your agents through the fastn MCP gateway, with permissions scoped per tenant and every call audited. Let an agent move a candidate to the next stage only after a recruiter approves the change
Who maintains the Breezy HR integration?
fastn does. When Breezy HR changes an endpoint, deprecates a field or alters its auth, the fix lands in the connector rather than in your backlog, and your customers' connections keep working.
How is candidate data from Breezy HR handled?
Access is scoped per tenant and limited to the fields you map, credentials are encrypted, and every read and write is logged. That matters more here than in most systems, because candidate records are personal data that carry consent and retention obligations.
Can my product react when a candidate's status changes in Breezy HR?
Yes, through event triggers: a stage move where Breezy HR owns the pipeline, or a completed assessment, a returned report or a finished reference where it owns one step in it. Events are delivered per tenant and can be replayed after an outage, so a hiring team does not silently lose an update while your product was unreachable.
What can I build with the Breezy HR integration?
A common starting point: let a customer connect their own Breezy HR account and pick which positions flow into your product. Teams also use it for the other use cases listed above, and expose it to agents for governed reads and writes.
How much does the Breezy HR integration cost?
It is included. Pricing is based on connected accounts, not on how many connectors you enable, so adding Breezy HR does not change your per-connector cost. You can start free with 3 connected accounts.
Add Breezy HR to your product
Start free with 3 connected accounts. No sales call required, and no per-customer integration code.