# SourceOutlook-Input

Read emails from an Outlook mailbox folder and save their file
attachments (or bodies as HTML) into one existing folder destination.

Must be the only source, with no processors and exactly one `folder`
destination — see validate_outlook_automation.

Type: object

Fields typed as another model are documented on that model's page; fetch it before filling the field.

| Field | Type | Required | Description | Allowed values / default / constraints |
| --- | --- | --- | --- | --- |
| `type` | string | yes | Marks this source as **Outlook**: emails from a mailbox folder, saved as files into a folder destination. | const: `"outlook"` |
| `account` | [OutlookAccount](https://dev-api.sheetgo.com/rest/reference/models/OutlookAccount.md) | no | `personal` (a personal Microsoft account) or `work` (work or school). It must be connected in Sheetgo with permission to read mail (412 `outlook_not_connected` otherwise). | default: `"personal"` |
| `mailbox` | [OutlookMailbox](https://dev-api.sheetgo.com/rest/reference/models/OutlookMailbox.md) | no | `inbox`, `archive` or `sent_items`. | default: `"inbox"` |
| `extract` | [OutlookExtract](https://dev-api.sheetgo.com/rest/reference/models/OutlookExtract.md) | no | `attachments` saves each email's file attachments; `body` saves each email's body as `<subject>.html`. | default: `"attachments"` |
| `process_once` | boolean | no | Skip emails already saved by an earlier run. | default: `true` |
| `email_filter` | [EmailFilter-Input](https://dev-api.sheetgo.com/rest/reference/models/EmailFilter-Input.md), nullable | no | Only read the emails that match these conditions. Omit to read every email (each run scans at most 1000). |  |
| `name` | string, nullable | no | Label for the source. Defaults to `Outlook`. |  |

## Used by

- [POST /rest/beta/automations/](https://dev-api.sheetgo.com/rest/reference/automations.md#post-rest-beta-automations)
- [PUT /rest/beta/automations/{id}](https://dev-api.sheetgo.com/rest/reference/automations.md#put-rest-beta-automations-id)
- [AutomationCreate](https://dev-api.sheetgo.com/rest/reference/models/AutomationCreate.md)
- [AutomationReplace](https://dev-api.sheetgo.com/rest/reference/models/AutomationReplace.md)

---

More: start page https://dev-api.sheetgo.com/rest/reference.md, everything in one file https://dev-api.sheetgo.com/rest/llms-full.txt, OpenAPI https://dev-api.sheetgo.com/rest/openapi.json.