Integration
HubHello
Two-way: staff in, alerts and summary out.
How to read Ratio's alerts feed and webhooks into HubHello, so expiring credentials show up where your team already looks each morning.
What comes into Ratio
- Staff records and roles
- Credential types with expiry dates
What Ratio sends back
- Alerts feed grouped at 90, 30 and 7 days
- Expired credential list
- Centre compliance summary for dashboards
How the fields map
Each record from HubHello lands on a specific field in Ratio. Status is calculated from the expiry date every time a page or report is opened.
| HubHello field | Ratio field | What happens |
|---|---|---|
| Employee / educator record | Staff record | Matched on work email first, then full name. Existing staff are updated, not duplicated. |
| Employee ID or payroll number | Contract number | Kept on the staff record and printed on the assessor evidence pack. |
| Position / role title | Role | Free text. Used for grouping the roster and for first aid coverage counts. |
| Qualification or certificate name | Credential type | Mapped to Ratio's credential catalogue (WWCC/Blue Card, first aid, anaphylaxis, asthma, CPR, qualification, police check). |
| Card / certificate number | Credential number | Stored as entered. Ratio records it; it does not verify it against a register. |
| Issue and expiry dates | Issued / expires | Expiry drives the live 90/30/7-day status at render time. Missing expiry shows as incomplete. |
| Attached certificate file | Evidence file | Images and PDFs up to 15 MB are stored against the credential. |
| Site / centre | Centre | Staff can belong to more than one centre in a group. |
Webhooks you can subscribe to
- credential.expiring
- credential.expired
Every delivery is signed so your system can verify it came from Ratio.
Worth knowing
- This page is an integration guide for Ratio's open REST API and webhooks — not a turnkey connector installed with one click. Your platform contact or IT person wires it up once.
- The alerts feed is read-only. Nothing in Ratio changes from reading it.
- Alerts are recalculated at request time, so the feed is never stale.