Skip to main content
GET
List And Create Inboxes
Lists every inbox in the AgentMail account. Returns count, limit, next_page_token and inboxes; page with next_page_token. Each inbox carries inbox_id, email, display_name, client_id, pod_id, metadata, created_at and updated_at. Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created, so this list is not scoped to you and the inboxes it returns may belong to someone else. Use get_agentmail_inbox for one inbox you already know the id of, and post_agentmail_inbox to create one.

Example

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/agentmail/inboxes
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/agentmail/inboxes
  • ascending: query; optional
  • limit: query; optional
  • page_token: query; optional
  • Runtime facts: 18a04e28941fae19674c11246b677373368b6bd927b7c146220cec1f168f4639
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.012
  • Cost contract: explicit_zero
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

ascending
boolean

Sort in ascending temporal order.

limit
integer

Limit of number of items returned.

page_token
string

Page token for pagination.

Response

Response with status 200

count
integer
required

Number of items returned.

inboxes
Inbox · object[]
required

Ordered by created_at descending.

limit
integer

Limit of number of items returned.

next_page_token
string

Page token for pagination.