Utility Account Set Up

Out of the box, ContactMonkey uses EWS (client side) to count the total number of recipients within the Distribution lists, dynamic lists and Office 365 groups that are placed in the “To” field during a campaign send. We use this recipient count as part of the analytics to help your Internal Comms team to help track their engagement. 

However, using EWS through the Office 365 web add-in has several restrictions, one of which is that the API has a 1mb limit on the response. Please note that as of October 2022, Microsoft has decommissioned basic authentication for EWS.

In order to bypass the above limitation, you will need to set up a graph utility account, or use our List Management Feature.

What happened to EWS?

In the past, we provided two options for setting up utility accounts, EWS & Graph. 

Microsoft have deprecated Basic Authentication which is what all third party applications rely on for EWS calls. We can therefore no longer support EWS utility accounts. 

Using Graph

In order to bypass this limitation, your team will need to create a utility account that has access to make the required Microsoft Graph calls. Once an account has been created, your account manager can enable the feature. This will allow your Org Owner/Admin to “Connect” the utility account using OAuth2. Once the Utility account has been connected, ContactMonkey will use this account when users within  the organization send Overall campaigns.

Users within the organization can also “Test” the count in advance of sending, to ensure their lists are supported. Please refer to the table below for supported list types

Type of List/Group EWS Graph
Mailbox Contact Group Supported Supported
Security Group Supported Supported
Universal Group Supported Supported
Dynamic Exchange Group Supported N/A
0365 Dynamic Group N/A Supported
0365 Group Supported Supported
Distribution groups with hidden membership N/A  Supported
Have more questions? Submit a request