> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.deepmask.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Messages

`outlook_list_messages`

Lists messages in an Outlook mail folder, ordered newest-first. Returns subject, sender, received date, read status, and a short body preview. Use `outlook_get_message` to retrieve the full body of a specific message.

## Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `folder_id` | string | No | Folder to list. Supports well-known names: `"inbox"`, `"drafts"`, `"sentitems"`, `"deleteditems"`, `"junkemail"`. Defaults to `"inbox"`. |
| `limit` | number | No | Max messages to return (1–100, default 20). |
| `offset` | number | No | Messages to skip for pagination (default 0). |
| `response_format` | string | No | Output format: `"markdown"` (default) or `"json"`. |

## Returns

An array of message objects, each with `id`, `subject`, `from`, `toRecipients`, `receivedDateTime`, `isRead`, `bodyPreview`, `importance`, `hasAttachments`, `webLink`, and `conversationId`.

## Example use

> "Show me my last 10 unread emails in the inbox."


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.