Application mail

GET /me/inbox Session or API key

List your mail, newest first, excluding deleted.

?body=1 returns each message's readable text inline and marks nothing read — that is the agent read path, so sweeping a backlog never zeroes the owner's unread count (GET /me/emails/{id} does mark read). Pages carrying bodies are capped at 50. An unknown source, status or link value is a 400, never a silently empty page.

Query parameters

source string
One account: gmail, hosted, or external.
status string
One classified label (see the triage vocabulary below).Example rejection
unclassified boolean
Only mail nothing has judged yet — the agent's work queue.
unread boolean
Only messages you have not opened.
link string
One link state: linked, suggested (awaiting your word), or unlinked.
q string
Match subject, sender, or body.
body boolean
Include each message body; caps the page at 50.
limit integer
Page size.
offset integer
Page offset.
curl
curl "https://freehire.me/api/v1/me/inbox?unclassified=1&body=1&limit=50" \
  -H "Authorization: Bearer fhk_…"
json — response
{
  "data": [
    {
      "id": 4821,
      "source": "gmail",
      "external_id": "<CAF...@mail.gmail.com>",
      "from_addr": "no-reply@us.greenhouse-mail.io",
      "from_name": "Speechify Recruiting",
      "subject": "Thank you for applying to Speechify",
      "snippet": "We have received your application…",
      "received_at": "2026-07-24T09:12:00Z",
      "read": false,
      "status_signal": "acknowledgement",
      "link_source": "thread",
      "linked_slug": "tech-lead-web-core-speechify-a1b2"
    }
  ],
  "meta": { "total": 137, "limit": 50, "offset": 0 }
}

Tailor your CV for this role?

We couldn't check your fit for this role — add a CV to your profile to see it next time.

A new version of HireAll is available