Exchange Web Services (EWS)
Interact with on-premise Microsoft Exchange mailboxes via the EWS SOAP API.
Exchange Web Services (EWS)
Exchange Web Services (EWS) is the SOAP/XML API for on-premise Microsoft Exchange servers. Use this block when you cannot use Microsoft Graph (e.g. Exchange 2013/2016/2019 without a cloud account).
Official documentation: https://learn.microsoft.com/exchange/client-developer/exchange-web-services
Setup
- Find your Exchange EWS endpoint URL. It typically looks like
https://mail.company.com/EWS/Exchange.asmx. Your Exchange administrator can confirm the exact address. - Obtain a username (in
DOMAIN\useroruser@company.comformat) and password for a mailbox account. - In AACFlow, add an EWS block and enter the EWS endpoint URL, username, and password. All credential fields are stored as secrets.
Basic authentication must be enabled on the Exchange server for this integration. Negotiate/Kerberos is not supported.
Operations
| Operation | Description |
|---|---|
ews_messages | List messages in a mailbox folder (default: inbox). Returns message summaries including subject, sender, and received time. |
ews_send | Send an email from the authenticated mailbox with To, Subject, Body (HTML supported), optional CC and BCC. |
ews_folders | List all top-level mailbox folders. |
Example workflow
Schedule a workflow to run every 15 minutes, call ews_messages to fetch unread emails, pass each message body to an AI block for classification, and route urgent items to a Slack notification.
Links
- Official docs: https://learn.microsoft.com/exchange/client-developer/exchange-web-services
- Block source: apps/aacflow/blocks/blocks/ews.ts