List threads

API referenceInbox

From the Inbox API reference. Requests use the base URL https://app.warmerly.com/api/v1 and an API key, see Authentication.

text

GET /inbox/threads

Returns email threads (grouped by threadKey + accountId) with aggregate counts, for building a mailbox-style view. Only email mailboxes in your workspace are included. This is account/folder-oriented, as opposed to /inbox/contacts, which is contact-oriented and spans channels.

Query param	Required	Description
`accountId`	No	Filter to a single email account. An account that is not in your workspace returns `404 not_found`.
`folder`	No	IMAP folder to filter by. Defaults to `INBOX`. Ignored unless `view` is `inbox`.
`view`	No	One of `inbox` (default), `archived`, `starred`, `sent`. Any other value applies no view filter.
`q`	No	Full-text search across subject, sender, and body (Postgres FTS with an ILIKE fallback).
`limit`	No	Max threads to return, `1` to `100`. Defaults to `50`.

bash

curl "https://app.warmerly.com/api/v1/inbox/threads?accountId=8f14e45f-ceea-4c6a-8c8d-6b1a5b5c9c1a&view=inbox&limit=20" \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

json

{
  "threads": [
    {
      "threadKey": "<CADx...@mail.gmail.com>",
      "accountId": "8f14e45f-ceea-4c6a-8c8d-6b1a5b5c9c1a",
      "lastReceivedAt": "2026-07-01T16:42:03.000Z",
      "messageCount": 4,
      "unreadCount": 1,
      "starred": false,
      "lastFromAddr": "jamie@northwindtraders.com",
      "lastFromName": "Jamie Rivera",
      "lastSubject": "Re: Quick question about your workflow",
      "lastSnippet": "Great, does Tuesday at 3pm work for a quick call?"
    }
  ]
}

Was this page helpful?

List threads

More from Inbox