Employee referrals
POST /me/referrals/offers Session or API key
Offer to refer into a company. Multipart — proof required.
The proof (an offer letter, badge, anything showing you work there) is stored privately and shown only to a moderator; its storage key is never exposed on the wire. The offer is pending until decided.
Body
company_slugstring (form field) required- The company you can refer into.
linkedin_urlstring (form field)- Your profile, for the moderator to check against.
prooffile (form field) required- Evidence you work there.
curl -X POST "https://freehire.me/api/v1/me/referrals/offers" \
-H "Authorization: Bearer fhk_…" \
-F company_slug=acme -F linkedin_url=https://linkedin.com/in/you -F proof=@badge.pdf{ "data": { "id": "b71e…", "company_slug": "acme", "company_name": "Acme", "status": "pending", "created_at": "2026-07-28T20:00:00Z" } }