MailgentAPI ReferenceThreads
List Threads
GET /v0/threads
List email threads in your agent's inbox. Returns most recently updated first.
Scope: mail:read
GET /v0/threadsQuery Parameters
| Param | Type | Default | Description |
|---|---|---|---|
limit | number | 50 | Max results (max 100) |
pageToken | string | — | Cursor from previous response |
Response 200
{
"threads": [
{
"threadId": "thd_a3f91b00c4e2d7e8",
"inboxId": "agent-x8k2m@mailgent.dev",
"subject": "Question about pricing",
"messageCount": 3,
"createdAt": "2026-03-28T10:00:00.000Z",
"updatedAt": "2026-03-28T14:30:00.000Z"
}
],
"count": 1,
"nextPageToken": "2026-03-28T09:00:00.000Z"
}Fields
| Field | Description |
|---|---|
threadId | Unique thread identifier |
subject | Subject of the first message |
messageCount | Total messages in thread |
updatedAt | When the last message was added |
cURL
curl https://api.mailgent.dev/v0/threads?limit=10 \
-H "Authorization: Bearer mgent-your-api-key"MCP
Tool: mail.list_threads