> For the complete documentation index, see [llms.txt](https://docs.senseloaf.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.senseloaf.ai/integrations/breezyhr-hr-workflow-guide.md).

# BreezyHR — HR Workflow Guide

What happens after BreezyHR is connected and what your team can do from there

This guide is for recruiters and hiring managers using SIA with BreezyHR. Once connected, SIA automatically syncs your open positions and candidate applications so you can run AI-powered matching, prescreening, and interviews without leaving your existing workflow. Results come back into BreezyHR as notes on the candidate and as movement through your pipeline — nobody on your team has to re-type, re-upload, or switch between two systems.

{% hint style="info" %}
**Note:** BreezyHR must be connected to SIA before any of this applies. If it hasn't been set up yet, ask your IT admin to follow the BreezyHR IT Setup Guide.
{% endhint %}

### How positions sync from BreezyHR

SIA checks your BreezyHR account every 15 minutes and pulls in every open position automatically — there's no manual job creation needed on your end.

{% hint style="info" %}
**Note:** BreezyHR refers to jobs as **positions** — you'll see this term used throughout the platform and in SIA Chat when working with BreezyHR data.
{% endhint %}

For each position it finds, SIA sets up three things automatically:

* **Job details** — the role, description, and requirements come across as-is from BreezyHR
* **A default resume matching strategy** — a starting set of criteria to score candidates against, based on the position itself, so scoring can begin right away
* **Workflow activation** — if the position already has a SIA user assigned, it goes live immediately and starts evaluating candidates

If a position doesn't yet have a SIA user assigned, it's held in **Draft** rather than going live — nothing is evaluated or acted on until someone is assigned to own it.

### Using BreezyHR questionnaire answers as matching criteria

If your BreezyHR position has a candidate questionnaire attached, SIA pulls in both the questions and each candidate's answers. You can turn any of these into a scored shortlisting criterion in your matching strategy, alongside skills and experience.

To add one, just tell SIA what you want in plain language while setting up the matching strategy. For example:

*"Include a criteria on this candidate question — 'Are you willing to relocate?'. Only Yes should qualify."*

SIA adds it as a scored criterion right away — no separate setup screen, no configuration file to edit.

{% hint style="info" %}
**Note:** This only works when BreezyHR is connected and the position has a questionnaire attached. Positions without one won't have this option available.
{% endhint %}

### How candidate stages sync back to BreezyHR

As candidates move through your hiring workflow in SIA, their stage updates sync back to BreezyHR — keeping your candidate pipeline aligned across both systems. Instead of manually updating candidates in multiple places, your team can manage the workflow in SIA and the relevant stage changes reflect in BreezyHR automatically.

SIA works with whatever pipeline your organisation already has set up — there is nothing new to create just to make this work. When a candidate moves from one stage to another in SIA, the corresponding stage is updated in BreezyHR, keeping the candidate's journey consistent across both platforms.

If a stage ever doesn't sync the way you expect, that mapping is the first thing to check — reach out to the Senseloaf team at <support@senseloaf.com> and it'll get sorted.

### Candidate sync and shortlisting

Alongside positions, SIA pulls in candidates from BreezyHR every 15 minutes for every active position, evaluates each one against that position's matching strategy, and ranks them by grade in the Candidate Listing — so your team opens a ready-sorted list rather than a raw pile of applications.

Whenever a candidate is shortlisted in SIA — whether your team does it manually or it happens automatically off a score — they are moved to the matching stage in BreezyHR, using the stage mapping configured for your organisation. The same happens when a candidate is disqualified.

### What lands back in BreezyHR

Every SIA evaluation — resume matching, prescreening, or an interview — automatically flows back to the candidate's BreezyHR profile in two ways:

* **As a scorecard entry** — the numeric score plus a note, visible directly on the candidate's record
* **As a plain-text note** in the candidate's discussion stream — showing the grade, summary, and a link to the full report in SIA

If your organisation has a custom attribute set up for the score, SIA writes the value there too. Either way, your team never has to leave BreezyHR to see how someone did.

Your team can review the evaluation outcome directly from BreezyHR with key insights at a glance. When they want to go deeper, they can jump straight into the full evaluation report in SIA. This gives hiring teams the flexibility to review from BreezyHR when they need a quick decision, or open SIA when they want the full picture.

### Interact with your BreezyHR data in SIA Chat

Once BreezyHR is connected, you can ask SIA about jobs, candidates, notes, and pipeline stages in plain language directly from SIA Chat. The prompts below are a starting point — explore more from directly within the SIA platform.

{% prompt description="Getting started" icon="bolt-lightning" openInAIProviders="false" %}

```markdown
What can I do with my BreezyHR integration?
```

{% endprompt %}

{% prompt description="Jobs and Application Status" icon="rotate" openInAIProviders="false" %}

```markdown
How many candidates are in each stage of the [Job Title] pipeline?
```

{% endprompt %}

{% prompt description="Update Notes" icon="file-import" openInAIProviders="false" %}

```markdown
Add a note to [Applicant Name] from [Job Name] in BreezyHR: strong on system design, weak on SQL.
```

{% endprompt %}

{% prompt description="Stage Changes" icon="rotate" openInAIProviders="false" %}

```markdown
Which candidates moved stages today because their score changed?
```

{% endprompt %}

### **Connecting your other tools**

SIA Chat isn't limited to BreezyHR. Since your other tools are connected to SIA too, you can act on the same candidates and jobs across Slack, Google Workspace, and email without leaving the conversation. Ask SIA to hand off a shortlist, a report, or a scheduling task to whichever tool your team actually works in — it'll route the request to the right connector automatically.

{% prompt description="Share update in channels" icon="paper-plane-top" openInAIProviders="false" %}

```markdown
Post today's shortlisted candidates to our #hiring Slack channel.
```

{% endprompt %}

{% prompt description="Export Date to Google Sheet" icon="file-import" openInAIProviders="false" %}

```markdown
Export this week's shortlist to a Google Sheet for the hiring manager.
```

{% endprompt %}

{% prompt description="Send Emails" icon="paper-plane-top" openInAIProviders="false" %}

```markdown
Send an email invite to [Candidate Name] for the next interview round.
```

{% endprompt %}

{% prompt description="Schedule Meetings" icon="calendar-day" openInAIProviders="false" %}

```markdown
Schedule a screening call with [Candidate Name] on my calendar for next week
```

{% endprompt %}

### Setting up and managing your workflow

For everything else, writing jobs, configuring agents, activating workflows, screening candidates, and shortlisting, the process is the same as the standard Senseloaf setup. Refer to the articles below:

* Configuring resume matching → [Create Matching Strategy](https://docs.senseloaf.ai/hiring-workflows/create-matching-strategy)
* Setting up prescreening → [Configure Prescreening](https://docs.senseloaf.ai/hiring-workflows/configure-prescreening)
* Setting up interviews → [Plan AI Interview](https://docs.senseloaf.ai/hiring-workflows/plan-ai-interview)
* Automating candidate progression → [Set Pipeline Automation](https://docs.senseloaf.ai/hiring-workflows/set-pipeline-automation)
* Reviewing your candidate pipeline → [Candidate Listing](https://docs.senseloaf.ai/agents-output/candidate-listing)
* Shortlisting and disqualifying → [Shortlist and Disqualify](https://docs.senseloaf.ai/candidate-pipeline/shortlist-and-disqualify)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.senseloaf.ai/integrations/breezyhr-hr-workflow-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
