Skip to content
Finowl

Email breach checks · HR and recruiting

Email breach checks for HR and recruiting platforms

HR platforms sit on personal data that attackers value, and many of the people logging in reuse email and password combinations from other services. Checking an address against Finowl Intelligence shows whether it appears in known breaches and which data classes leaked. For recruiters and HR administrators, an exposed address with leaked passwords is a strong reason to require two-factor authentication before they can open candidate pools or payroll settings.

For employees using self-service portals, the same check can gate sensitive changes. Before someone updates direct deposit details, a breached email combined with a new device can trigger extra verification through a channel the company already trusts. The check is about protecting the account, not judging the person, so it should never affect hiring outcomes, performance reviews or eligibility for any role.

USE CASES

Where it fits in hr and recruiting

HOW TO INTEGRATE

The workflow

  1. 1

    Store FINOWL_API_KEY in your HR platform's secret manager and call Finowl only from backend services.

  2. 2

    Call POST /v1/breaches/email when a privileged role is granted and before sensitive self-service changes.

  3. 3

    Evaluate breached, DataClasses and BreachDate to decide whether to require two-factor or step-up verification.

  4. 4

    Keep breach results out of candidate profiles and hiring records so they cannot influence employment decisions.

  5. 5

    Handle 429 responses by waiting for Retry-After and treat 5xx responses as unknown rather than blocking access.

POST /v1/breaches/email
curl https://api.finowl.co/v1/breaches/email \
  -H "Authorization: Bearer $FINOWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "talent.partner@example.com"
}'

Checks a recruiter's work address when they are granted access to a candidate pool. Exposure triggers mandatory two-factor setup; it is never stored on a candidate or employee record.

GOOD PRACTICE

Before you ship

Read the API reference for every field and error code. Each lookup costs 1 credit; see pricing.

A FEW GOOD QUESTIONS

Common questions

Email breach checks for HR and recruiting platforms

Start with 100 free credits every month and test the request above in the sandbox.