Set Up Outlook and Apple Mail (EWS)
Outlook and Apple Mail can connect to WisMail in two ways: as an Exchange account, through Autodiscover and Exchange Web Services (EWS), or as a standard IMAP and SMTP account. No Outlook Connector is needed or offered. This guide shows both and says plainly what EWS does not do. The overview is on the EWS feature page.
Which method should I choose?
| Method | Gives you | Choose it when |
|---|---|---|
| Exchange account (Autodiscover + EWS) | Mail, calendar, contacts, tasks in one account | You want the full Exchange-style experience and your DNS and certificate are in place |
| IMAP + SMTP, plus CalDAV/CardDAV | Mail over IMAP; calendar and contacts through standards | You want the most widely tested path, or EWS does not suit your version |
We do not promise behaviour for every Outlook or Apple Mail version. Try your own versions during the free trial; if the Exchange route is awkward, the IMAP route always works.
Before you start
- Your email address and password (or an app password, if you use two-step verification: create it in webmail Settings, App Passwords).
- A server certificate that the computer trusts, such as Let's Encrypt. Public certificates avoid every warning.
- For Autodiscover, a DNS record
autodiscover.example.compointing at the server and a certificate that includes the name. See the DNS guide.
1. Outlook for Windows: Autodiscover
- Open Outlook, choose File, Add Account and type your email address.
- Click Connect. Outlook looks for the server's Autodiscover service, which the server answers at
/autodiscover/autodiscover.xmlover HTTPS. - Enter your password when asked and accept the prompt to remember it.
- Wait for the folders, calendar and contacts to load.
If automatic setup fails, look for Advanced options or the manual account setup and choose the Exchange option, or use the IMAP method in step 4.
2. Outlook for Mac
- Open Outlook, choose Add Account and enter your email address.
- Choose Exchange and enter your user name (full email address) and password.
- If Outlook asks for the server address, use the ActiveSync address from webmail: open the user menu, choose Integration with Mac and copy ActiveSync address.
3. Apple Mail, Calendar and Contacts on a Mac
The easiest way is the page built into webmail. Open the user menu and choose Integration with Mac; it lists your server values, each with a Copy button, and short steps for Mail, Calendar and Contacts:
- Open System Settings, Internet Accounts, Add Account. For mail choose Other Account, Mail account, or Exchange if you want the Exchange route.
- Enter your name, email address and password.
- At the server step enter your server name for both incoming and outgoing mail, choose IMAP, keep SSL/TLS on and sign in.
- For calendar add a CalDAV account (account type Advanced) and for contacts a CardDAV account, with your user name, password and the server address shown on the page.
If something is missing on the Exchange route, switch the mail account to IMAP.
4. IMAP and SMTP fallback (any version)
Create a new account with these values:
| Setting | Value |
|---|---|
| Incoming (IMAP) | your server name, port 993, SSL/TLS (143 with STARTTLS) |
| Outgoing (SMTP) | your server name, port 587 with STARTTLS (465 with SSL/TLS), authentication required |
| User name | your full email address |
| Password | your password, or an app password if 2FA is on |
Add calendar and contacts with CalDAV and CardDAV (https://<server-name>/caldav/ and https://<server-name>/carddav/) in clients that support them, such as Apple Calendar, Apple Contacts and Thunderbird.
5. Manual EWS address
Some clients ask for the Exchange server address instead of using Autodiscover. The service address is https://<server-name>/EWS/Exchange.asmx on port 443 with Basic authentication over TLS. Autodiscover is at https://<server-name>/autodiscover/autodiscover.xml.
Known EWS limits
EWS in WisMail covers folders, mail, calendar, contacts, tasks, synchronisation, free/busy lookup, the out-of-office reply and pull and streaming notifications. It does not support:
- sending mail with the SendItem operation,
- CopyFolder,
- push-style notifications.
A client that depends on one of these may behave differently or fall back to its own method. If a feature misbehaves on the Exchange route, use IMAP/SMTP for mail and CalDAV/CardDAV for calendar and contacts, which are the paths we have tested most widely. On phones prefer ActiveSync.
Troubleshooting
- Outlook keeps asking for the password. Re-enter it, check the user name is the full address, and use an app password when 2FA is on.
- Certificate warning. The certificate must match the name the client connects to; add
autodiscover.example.comwhen you request the Let's Encrypt certificate, or connect with the manual EWS address. - Autodiscover not found. Check the DNS record with
dig +short CNAME autodiscover.example.com. SRV records are untested, so create the CNAME. - Port blocked. The computer must reach port 443 (Exchange route) or 993 and 587 (IMAP route).
- Everything stopped. Check that the license is valid; see license activation.
Next steps
- Send and receive from the browser: Using webmail.
- Phones: Email on iPhone and Android.
- Admin: DNS records and administration.
- Compare plans and start the free trial.