List inboxes
agentmail/list-inboxesList the email inboxes on the account, newest first.
- call
- $0.002
- AgentMail
- 5 min
Overview
Returns the account's inboxes ordered by when they were created, each with its inbox identifier, email address, timestamps, and any display name or metadata set when it was created. A page size caps how many come back per call, and when more remain the response carries an opaque token to pass on the next request. The order can be flipped to oldest first.
A count and a list of inboxes with their id, address, and timestamps, plus a token when more remain.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | How many inboxes to return. |
| page_token | string | No | The token from a previous response, to continue the listing. |
| ascending | boolean | No | Return oldest first instead of newest first. |
Requests up to 1 MB.
Example
A call that works, with your own key.
curl https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-d '{"provider":"agentmail","endpoint":"list-inboxes","input":{"limit":20}}'Pricing
$0.002 per call on the default plan. Every run carries its price in the response.