This article helps a System Administrator identify and resolve errors related to MAPI or EWS license assignments within SmarterMail. This process is required for users who need to connect their SmarterMail accounts to Microsoft Outlook using MAPI or EWS protocols.
Important: This feature is only available on SmarterMail plans that include the appropriate MAPI/EWS licenses.
Before you begin
You will need:
System Administrator access to the SmarterMail server.
The specific email address of the mailbox experiencing the license error.
The SmarterMail management console.
Troubleshooting the license assignment
If a user reports a "License Not Found" or "Invalid License" error when attempting to connect via MAPI or EWS, follow these steps to verify and correct the assignment.
Log in to the SmarterMail administration panel.
Navigate to Administration > Mailbox Management.
Locate the affected mailbox in the list and select Edit.
Scroll to the Advanced or Protocols section (depending on your SmarterMail version).
Locate the MAPI/EWS settings.
Verify that the MAPI/EWS checkbox is enabled.
If the checkbox is enabled but the error persists, click Save to refresh the configuration.
If the checkbox is disabled, enable it and click Save.
Verify the license status
If the settings appear correct but the error remains, the license may not be active at the account level.
Navigate to Administration > License Management.
Locate the MAPI/EWS license.
Verify that the license is active and has available seats.
If the license is not active, contact Hostek to add the necessary licenses to your account.
Confirm the result
The resolution is successful when:
The user can successfully authenticate and sync their mail using the MAPI or EWS protocol in Microsoft Outlook.
The SmarterMail administration panel shows the MAPI/EWS option as enabled for the specific mailbox.
Limitations
This procedure only addresses license assignment errors. It does not resolve issues related to incorrect server addresses, port blocks, or local firewall settings.
If the license is active but the connection fails, ensure the user is using the correct server hostname and port for the MAPI/EWS protocol.
