Skip to main content
GET
List 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

Authorizations

Authorization
string
header
required

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

Headers

Authorization
string
required

Bearer authentication

Query Parameters

limit
integer

Limit of number of items returned.

page_token
string

Page token for pagination.

ascending
boolean

Sort in ascending temporal order.

Response

200 - application/json

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.