mail. read_ list
List messages in a Microsoft 365, Outlook.com, or IMAP mailbox folder.
2 credits. Per call.
Example prompt
Send this to your AI app when Heelo is connected:
What's in my inbox?
Input fields
| Field | Type | Description |
|---|---|---|
account_handle | string | Which configured mailbox to read. Optional when only one is configured. |
folder | string | Mailbox folder to list. |
since | string | Lower bound on received time, UTC ISO-8601 (e.g. 2026-09-01T00:00:00Z). |
query | string | Optional text to match against subject, sender and body. |
limit | integer | Page size (max 200). |
cursor | string | Opaque cursor returned by a previous call, to fetch the next page. |
end_user_id | string | Optional end-user scope for multi-tenant callers. |
Output fields
The fields in data when status is success.
| Field | Type |
|---|---|
account | object |
provider | string |
folder | string |
count | integer |
messages | array of object |
next_cursor | string |
more | boolean |
available_accounts | array of string |
query | string |
since | string |
untrusted | boolean |
Code
The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.
import os
import requests
response = requests.post(
"https://toolsprimitives.uk/v1/tools/mail.read_list/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {}},
timeout=120,
)
response.raise_for_status()
print(response.json())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/mail.read_list/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());