All integrations

Breathe HR

BUSINESS · PEOPLE

Employees, absences, leave requests, and expenses from their own company.

Connecting Breathe HR in practice

Breathe allows "a maximum of 60 requests in 60 seconds per customer" — one bucket for the whole company, not per API key — and caps a page at 100 records, so a full employee-and-absence sync for a few hundred staff spends most of a minute and competes with every other integration the customer has connected.

Rate limits

  • 60 requests in 60 seconds per customer. Over the limit the response is a 429 with a rate limit error.
  • Pagination defaults to 25 records per page and accepts per_page "up to a maximum of 100".
  • Paginated responses include a Total HTTP header with the total number of results.

Worth knowing

  • The quota is per customer rather than per credential, so adding a second integration to the same Breathe account halves what the agent gets and no amount of key rotation helps.
  • Sandbox and production are separate worlds: the sandbox key is issued on the developer site and works against isolated test data, so a key that works in testing is not the key that ships.
  • At 100 records a page and 60 requests a minute, the practical ceiling is about 6,000 records a minute even when nothing else is running.

Checked against Breathe API FAQs (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

breathehr_delete_v1_employee_expense_claims_by_idWRITE

Delete employee expense claim via DELETE /v1/employee_expense_claims/{id}

api
breathehr_delete_v1_employee_expenses_by_idWRITE

Delete employee expense via DELETE /v1/employee_expenses/{id}

api
breathehr_delete_v1_employee_training_courses_by_idWRITE

Delete employee training course via DELETE /v1/employee_training_courses/{id}

api
breathehr_delete_v1_sicknesses_by_idWRITE

Delete sickness via DELETE /v1/sicknesses/{id}

api
breathehr_get_v1_absencesREAD

List absences via GET /v1/absences

api
breathehr_get_v1_accountREAD

Get account via GET /v1/account

api
breathehr_get_v1_benefitsREAD

List benefits via GET /v1/benefits

api
breathehr_get_v1_bonusesREAD

List bonuses via GET /v1/bonuses

api
breathehr_get_v1_change_requestsREAD

List change requests via GET /v1/change_requests

api
breathehr_get_v1_company_documentsREAD

List company documents via GET /v1/company_documents

api
breathehr_get_v1_company_projectsREAD

List company projects via GET /v1/company_projects

api
breathehr_get_v1_company_projects_by_idREAD

Get company project via GET /v1/company_projects/{id}

api
breathehr_get_v1_company_training_typesREAD

List company training types via GET /v1/company_training_types

api
breathehr_get_v1_departmentsREAD

List departments via GET /v1/departments

api
breathehr_get_v1_departments_by_id_absencesREAD

List department absences via GET /v1/departments/{id}/absences

api
breathehr_get_v1_departments_by_id_benefitsREAD

List department benefits via GET /v1/departments/{id}/benefits

api
breathehr_get_v1_departments_by_id_bonusesREAD

List department bonuses via GET /v1/departments/{id}/bonuses

api
breathehr_get_v1_departments_by_id_leave_requestsREAD

List department leave requests via GET /v1/departments/{id}/leave_requests

api
breathehr_get_v1_departments_by_id_salariesREAD

List department salaries via GET /v1/departments/{id}/salaries

api
breathehr_get_v1_divisionsREAD

List divisions via GET /v1/divisions

api
breathehr_get_v1_employee_expense_claimsREAD

List employee expense claims via GET /v1/employee_expense_claims

api
breathehr_get_v1_employee_expense_claims_by_idREAD

Get employee expense claim via GET /v1/employee_expense_claims/{id}

api
breathehr_get_v1_employee_expensesREAD

List employee expenses via GET /v1/employee_expenses

api
breathehr_get_v1_employee_expenses_by_idREAD

Get employee expense via GET /v1/employee_expenses/{id}

api
breathehr_get_v1_employee_jobsREAD

List employee jobs via GET /v1/employee_jobs

api
breathehr_get_v1_employee_training_coursesREAD

List employee training courses via GET /v1/employee_training_courses

api
breathehr_get_v1_employeesREAD

List employees via GET /v1/employees

api
breathehr_get_v1_employees_by_idREAD

Get employee via GET /v1/employees/{id}

api
breathehr_get_v1_employees_by_id_absencesREAD

List employee absences via GET /v1/employees/{id}/absences

api
breathehr_get_v1_employees_by_id_benefitsREAD

List employee benefits via GET /v1/employees/{id}/benefits

api
breathehr_get_v1_employees_by_id_bonusesREAD

List employee bonuses via GET /v1/employees/{id}/bonuses

api
breathehr_get_v1_employees_by_id_change_requestsREAD

List employee change requests via GET /v1/employees/{id}/change_requests

api
breathehr_get_v1_employees_by_id_employee_holiday_yearsREAD

List employee holiday years via GET /v1/employees/{id}/employee_holiday_years

api
breathehr_get_v1_employees_by_id_leave_requestsREAD

List employee leave requests via GET /v1/employees/{id}/leave_requests

api
breathehr_get_v1_employees_by_id_salariesREAD

List employee salaries via GET /v1/employees/{id}/salaries

api
breathehr_get_v1_employees_by_id_sicknessesREAD

List employee sicknesses via GET /v1/employees/{id}/sicknesses

api
breathehr_get_v1_holiday_allowancesREAD

List holiday allowances via GET /v1/holiday_allowances

api
breathehr_get_v1_leave_requestsREAD

List leave requests via GET /v1/leave_requests

api
breathehr_get_v1_leave_requests_by_idREAD

Get leave request via GET /v1/leave_requests/{id}

api
breathehr_get_v1_leave_requests_by_id_cancellingREAD

Get leave request cancelling state via GET /v1/leave_requests/{id}/cancelling

api
breathehr_get_v1_leave_requests_other_leave_reasonsREAD

List leave request other-leave reasons via GET /v1/leave_requests/other_leave_reasons

api
breathehr_get_v1_locationsREAD

List locations via GET /v1/locations

api
breathehr_get_v1_other_leave_reasonsREAD

List other-leave reasons via GET /v1/other_leave_reasons

api
breathehr_get_v1_salariesREAD

List salaries via GET /v1/salaries

api
breathehr_get_v1_sicknessesREAD

List sicknesses via GET /v1/sicknesses

api
breathehr_get_v1_statutory_holiday_countriesREAD

List statutory holiday countries via GET /v1/statutory_holiday_countries

api
breathehr_get_v1_working_patternsREAD

List working patterns via GET /v1/working_patterns

api
breathehr_post_v1_absences_by_id_cancelWRITE

Cancel absence via POST /v1/absences/{id}/cancel

api
breathehr_post_v1_employee_expense_claimsWRITE

Create employee expense claim via POST /v1/employee_expense_claims

api
breathehr_post_v1_employee_expensesWRITE

Create employee expense via POST /v1/employee_expenses

api
breathehr_post_v1_employee_training_coursesWRITE

Create employee training course via POST /v1/employee_training_courses

api
breathehr_post_v1_employeesWRITE

Create employee via POST /v1/employees

api
breathehr_post_v1_employees_by_employee_id_change_requests_by_id_approveWRITE

Approve employee change request via POST /v1/employees/{employee_id}/change_requests/{id}/approve

api
breathehr_post_v1_employees_by_id_change_requestsWRITE

Create employee change request via POST /v1/employees/{id}/change_requests

api
breathehr_post_v1_employees_by_id_leave_requestsWRITE

Create employee leave request via POST /v1/employees/{id}/leave_requests

api
breathehr_post_v1_employees_by_id_sicknessesWRITE

Create employee sickness via POST /v1/employees/{id}/sicknesses

api
breathehr_post_v1_leave_requests_by_id_approveWRITE

Approve leave request via POST /v1/leave_requests/{id}/approve

api
breathehr_post_v1_leave_requests_by_id_rejectWRITE

Reject leave request via POST /v1/leave_requests/{id}/reject

api
breathehr_put_v1_employee_expense_claims_by_idWRITE

Update employee expense claim via PUT /v1/employee_expense_claims/{id}

api
breathehr_put_v1_employee_expenses_by_idWRITE

Update employee expense via PUT /v1/employee_expenses/{id}

api
breathehr_put_v1_employee_training_courses_by_idWRITE

Update employee training course via PUT /v1/employee_training_courses/{id}

api
breathehr_put_v1_sicknesses_by_idWRITE

Update sickness via PUT /v1/sicknesses/{id}

api

Put Breathe HR behind one governed endpoint.

Same permissions, same audit trail, whatever else you connect next.