Employee referrals
POST /me/referrals/requests Session or API key
Ask a company's approved referrers for an intro.
Validation failures answer 422; a company with no approved referrer answers 409; too many open requests answers 429.
Body
company_slugstring required- The company to ask.
job_idinteger- The specific opening, when there is one.
cv_kindstring- Which CV to attach: your stored one, or a built CV.
cv_idstring (uuid)- The built CV to attach, when
cv_kindnames one. linkedin_urlstring- Your profile.
contact_telegramstring- How the referrer reaches you.
contact_emailstring- How the referrer reaches you.
notestring- A short message to the referrer.
curl -X POST "https://freehire.me/api/v1/me/referrals/requests" \
-H "Authorization: Bearer fhk_…" -H 'Content-Type: application/json' \
-d '{"company_slug":"acme","cv_kind":"stored","contact_email":"you@example.com"}'{ "data": { "id": "c92f…", "company_slug": "acme", "status": "open", "created_at": "2026-07-28T20:05:00Z" } }