Common Issues

Connection issues

My API key is not being accepted

Double-check that you copied the full API key from Breezy HR without any leading or trailing spaces. In Breezy HR, go to Account Settings → Integrations → API to find and regenerate your key if needed. If your key was recently regenerated, make sure you've updated it in Coupler.io as well.

The data flow connects but returns no data

This usually means your Breezy HR account has no records for the selected entity, or all positions are in a draft state not visible via the API. Check that the entity you selected (Positions, Candidates, or Pipelines) has at least one record in your Breezy HR account.

Missing data

Some candidates are missing from my results

Candidates who were archived or deleted in Breezy HR may not appear in the export. Also confirm that the candidates are associated with an active or published position — candidates tied only to draft positions may not be returned.

Pipeline stages are missing or incomplete

Pipeline stages are configured per position in Breezy HR. If a position uses a non-default pipeline, the stages will reflect that position's custom setup. Make sure you're joining Pipelines data with the correct Position ID to get the right stages.

Candidate source field is blank

The source field is only populated when it was explicitly set during the application process or added manually in Breezy HR. Candidates added without a source attribution will have a blank value — this is expected behavior from the Breezy HR API.

Permission errors

I get a 401 or "unauthorized" error

This means your API key is invalid or has been revoked. Regenerate your API key in Breezy HR → Account Settings → Integrations → API, then update the key in your Coupler.io data flow settings.

Only account owners and admins in Breezy HR can access and generate API keys. If you don't see the API section, ask your Breezy HR administrator.

Data discrepancies

Candidate counts in Coupler.io don't match Breezy HR's dashboard

Breezy HR's dashboard may apply default filters (e.g., hiding disqualified candidates). The Coupler.io export pulls all candidate records available through the API, including disqualified ones. Filter by the Stage field in your destination to match what you see in Breezy HR.

A position shows as open in Breezy HR but closed in my export

This can happen if the position state was changed after your last data flow run. Run the data flow manually again to pull the latest status, or schedule more frequent syncs for time-sensitive reporting.

Rate limits

My data flow fails with a rate limit error

Breezy HR's API has rate limits that can be hit when syncing large volumes of candidates or running multiple data flows simultaneously. Space out your data flows or reduce sync frequency if you hit this issue. If it persists, contact Breezy HR support to review your API usage limits.