ArgorantDocs

List mailboxes

gethttps://app.argorant.com/api/v1/inboxes
GET
/api/v1/inboxes

The mailboxes connected to your workspace (Google, Microsoft and any other provider), a page at a time and ordered by address, with status, today's sends against the daily limit, tags, warm-up and what needs fixing. Narrow it by domain, status, tag, provider or text. The first page also has summary: how many mailboxes are in each status, on each domain and with each tag. No passwords or tokens are ever returned.

CostWhat it doesKey scopes
FreeReads onlyargorant:read_counts

Authorization

BearerAuth
AuthorizationBearer <token>

Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.

In: header

Query Parameters

limit?integer

Rows per page, 1 to 500 (default 50).

Range1 <= value <= 500
Default50
cursor?string

The next_cursor of the previous page. Leave out for the first page.

domain?string

One domain, or several separated by commas.

status?string

sendable, warming, not_connected, needs_attention or paused; several separated by commas.

tag?string

Mailboxes that carry this tag; several separated by commas means all of them. Capitals do not matter.

provider?string

google, ms365 or smtp.

Value in

  • "google"
  • "ms365"
  • "smtp"
q?string

Text in the address or the name.

summary?boolean

Set false to leave the summary out of the first page.

summary_domains?integer

How many domains the summary lists, 0 to 500 (default 25).

Range0 <= value <= 500
Default25

Header Parameters

X-Request-Id?string

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Match^[A-Za-z0-9._-]{8,64}$

Response Body

application/json

application/json

application/json

application/json

application/json

Shell
curl -X GET "https://app.argorant.com/api/v1/inboxes?limit=50&domain=northgate-advisory.com&status=needs_attention"
JSON
{  "inboxes": [    {      "email": "elena@northgate-advisory.com",      "name": "Elena Vaughn",      "provider": "google",      "domain": "northgate-advisory.com",      "status": "sendable",      "status_label": "Sending",      "daily_limit": 40,      "sent_today": 38,      "tags": [        "outbound"      ],      "needs_attention": false,      "warmup": {        "on": true,        "per_day": 10      }    }  ],  "total": 1,  "limit": 50,  "next_cursor": null,  "has_more": false,  "filters": {    "domain": [      "northgate-advisory.com"    ]  },  "summary": {    "total": 1,    "by_status": {      "sendable": 1    },    "domains_total": 1,    "by_domain": [      {        "domain": "northgate-advisory.com",        "total": 1,        "by_status": {          "sendable": 1        }      }    ],    "by_tag": [      {        "tag": "outbound",        "total": 1      }    ]  }}

Mailboxes

The mailboxes that send your campaigns. List and change them, connect a whole Google Workspace in one step, connect a mailbox from any other email provider with its server settings, or order new mailboxes on new domains: a quote, a yes, then a payment link or the saved card.

Disconnect a mailbox DELETE

Next Page