List Connected Mailboxes

Returns every active mailbox connected to Allegrow in your workspace, with its owner, connection status, and reputation.

The list always contains all connected mailboxes — the reputationRange parameter never filters the list; it only sets the time window the reputation figure is averaged over (the same number the in-app leaderboard shows for that range). A mailbox with no reputation data in the window (for example, one connected in the last few days) still appears, with reputation: null.

Results are sorted by email ascending and paginate with limit/offset.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Returns every active mailbox connected to Allegrow in your workspace, with its owner, connection status, and reputation — the API equivalent of the in-app leaderboard.

Two things worth knowing:

  • The list always contains all connected mailboxes. reputationRange never filters the list — it only sets the window the reputation average is computed over (default last30Days; the response echoes the resolved window).
  • A mailbox with no reputation data in the window still appears, with reputation: null. Connection visibility is the point: if it's connected, it's listed.

Use connectionStatus to slice the list server-side — ?connectionStatus=credentials_error with limit=1 turns total into a "mailboxes needing attention" metric in one cheap call.

owner identifies the user the mailbox belongs to, and is null in the rare case the owning user no longer exists in the workspace.

For a single mailbox's day-by-day history, see Get Connected Mailbox.

Query Params
string
enum

Time window the per-mailbox reputation average is computed over. Defaults to last30Days. The response echoes the resolved window in its reputationRange field.

string

Return only mailboxes whose connectionStatus matches (e.g. connected, disconnected, credentials_error). Case-insensitive. total reflects the filtered count.

integer
1 to 1000
Defaults to 50

Page size (1–1000). A single page can hold an entire workspace — for a full snapshot request limit=1000 rather than stitching offset pages, which are computed independently.

integer
≥ 0
Defaults to 0

Zero-based index of the first entry to return.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json