;}%20.st6{fill:url(%23SVGID_00000021089067129159788970000008246765442136188072_);}%20.st7{fill:url(%23SVGID_00000117639240116366130650000015074833605515028638_);}%20.st8{opacity:0.4;fill:url(%23SVGID_00000101781798616409025840000016567063639337360777_);}%20.st9{opacity:0.4;fill:url(%23SVGID_00000052086836598721292040000002033117744178971046_);}%20.st10{opacity:0.4;fill:url(%23SVGID_00000159460939004760751800000002448009281983951536_);}%20.st11{opacity:0.4;fill:url(%23SVGID_00000013177830667419993080000017721442101626521532_);}%20.st12{opacity:0.4;fill:url(%23SVGID_00000152235521444854938490000006526001119318383285_);}%20.st13{opacity:0.4;fill:url(%23SVGID_00000119823135212293698520000012774889010992664993_);}%20%3c/style%3e%3cg%3e%3cpolygon%20class='st2'%20points='134.78,14.22%20114.31,48.21%20101.33,69.75%20158.22,69.75%20177.97,36.95%20191.67,14.22%20'/%3e%3cpolygon%20class='st3'%20points='227.55,69.75%20186.61,69.75%20101.33,69.75%20129.78,119.02%20158.16,119.02%20228.61,119.02%20256,119.02%20'/%3e%3cpolygon%20class='st3'%20points='136.93,132.47%20116.46,167.93%2073.82,241.78%20130.71,241.78%20144.9,217.2%20180.13,156.18%20193.82,132.46%20'/%3e%3cpolygon%20class='st3'%20points='121.7,131.95%20101.23,96.49%2058.59,22.63%2030.15,71.91%2044.34,96.49%2079.57,157.5%2093.26,181.22%20'/%3e%3cpolygon%20class='st2'%20points='64.81,131.95%2025.15,131.21%200,130.74%2028.44,180.01%2066.73,180.72%2093.26,181.21%20'/%3e%3cpolygon%20class='st2'%20points='165.38,181.74%20184.58,216.46%20196.75,238.47%20225.19,189.2%20206.66,155.69%20193.83,132.46%20'/%3e%3c/g%3e%3c/svg%3e)
Windmill HubSend, search, read, organize and draft email, and manage calendar events and contacts, in a Microsoft 365 or Outlook.com account from any Windmill script, flow or app.
Set up in 2 steps
Connect from the Resources page
Open Resources, click Add a resource/API and pick ms_outlook from the OAuth APIs list. Click Connect and sign in with the Microsoft account that owns the mailbox, then name the resource and save it. The default permissions cover mail, calendar and contacts.
Run your first script
Fork the send email script below, or any mail, calendar or contact script: they all run on a default connection.
Scripts
Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.
New Email
Modify Email
Update Calendar Event
Update Contact
Send Email
Send Draft
Search People
Respond to Event
Reply to Email
Move Email to Folder
List Time Zones
Find Emails
List Folders
List Events
List Event Instances
Find Contacts
List Categories
List Calendars
List Attachments
Get Free/Busy Schedule
Get Message
Get Folder
Get Event
Get Current User
Find Meeting Times
Download Attachment
Delete Calendar Event
Create Calendar Event
Create Draft Reply
Create Draft Email
Trigger flows from Microsoft Outlook
Microsoft Outlook is not only a destination. These inbound paths are supported today.
New email (scheduled poll)
In a flow, add a trigger, choose Scheduled Poll, pick the New Email script and an interval. Each run emits the messages that arrived in the chosen folder since the previous one. It polls because Microsoft Graph push notifications need a subscription that is renewed every few days against a public endpoint.
Resource type
The shape of the credential every script on this page expects.
ms_outlook
View raw schema →| Field | Type | Required | What it is |
|---|---|---|---|
| token | string | Yes | Microsoft Graph access token. Filled in and refreshed by Windmill when you connect with OAuth. |
Questions
What can Windmill do with my mailbox?
By default: read, send, draft, move and modify mail, read and write calendar events, and read and write contacts, for the account you sign in with (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, Contacts.ReadWrite, plus User.Read and offline_access). Untick what you don't need in the connect dialog. Listing categories (MailboxSettings.Read), searching people (People.Read), finding meeting times (Calendars.Read.Shared) and shared mailboxes are not in the default: tick them when connecting, or reconnect an existing resource.
There is no Connect button on my instance
Self-hosted instances need an admin to register an app in Microsoft Entra ID once, then add Outlook under Instance settings, OAuth, with its client id, secret and tenant. Use common as the tenant for a multi-tenant app or personal accounts, or your tenant id for a single-tenant app. The app's redirect URI is <your instance>/oauth/callback/ms_outlook.
Can scripts act on a shared mailbox?
Yes. Mail scripts take an optional mailbox argument, the address or id of a mailbox the connected account has been granted access to. The connection then needs the Shared variant of the permission, for example Mail.Read.Shared or Mail.Send.Shared, which is not in the default: tick it when connecting.
Does it work with a personal Outlook.com account?
Mail, calendar and contacts do, when the Entra app allows personal accounts and the tenant is set to common. Find meeting times is only available to work or school accounts.