We're experiencing difficulty. Our engineers are on it. Please check status.mailgun.com for real-time updates.

Configuring the account custom message limit

Article Preview


    You can set a custom message limit for your entire account within the Settings of the Mailgun Control Panel. When the custom message limit is reached, the account will be disabled until you choose to re-enable the account. When an account is disabled, sending will be halted, but the dashboard and its functionality will still be accessible.

    Note: It is not possible within Mailgun to configure custom message limits for individual domains.

    Note: You must set the custom message limit per region if you have domains in both the US and EU regions. Otherwise, for example, if you have domains in the EU region, but only configure the custom message limit for the US region, there will not be a limit applied to the domains in the EU region.


    Understanding the context


    Setting the scene

    Most of us probably are at least a little concerned about out-of-control sending - such as due to a coding loop or a malicious actor attempting to use a contact form to send as much spam as possible before being noticed - so it's only natural to desire some way to limit such possibilities.  

    The good news is that Mailgun offers a custom message limit that is configured at the account level.  Once configured, if the total messages sent by all US domains on the account reach the specified limit, the account will be disabled.  While disabled, you can review logs and statistics to determine if reaching the limit was expected or unexpected.  In either case, you maintain control over the account, which means you can re-enable it when ready.  However, keep in mind that if you do not enable the account before the start of a new calendar month, the account will automatically re-enable.

    When an account is disabled for reaching the custom message limit, the primary account owner will receive an email alert from Mailgun informing them of the disablement.  Moreover, the primary account owner is also notified when 50% and 75% of the limit have been reached.


    Discerning the nuance

    The custom message limit applies to all messages sent during the billing cycle which begins on the first day of the month and ends on the last day of the month. Any sending that was conducted during the month before the limit was set will already be applied to the custom message limit message count. The custom message limit counter will reset to zero at the beginning of each month. 

    As an example, let's say your account has sent 4,000 messages as of the middle of March, and you have just set a custom message limit at 5,000.  The count will start at 4,000. If the account sends another 1,000 messages, the account will reach the custom message limit and be disabled.  

    Finally, as mentioned above, the custom message limit is an account-level feature; as such, it cannot be configured for domains and will disable the whole account.


    Things to be aware of

    This is a great tool to have, but keep in mind that there is a slight delay before the disablement occurs due to processing speed. For example, if a custom message limit set at 1,000 was exceeded, you may not see the disablement occur until 1,015 messages were processed. This delay is an inconsistent value that can not be calculated. 

    When enabling the account after a custom message limit disablement, the account will immediately be ready again for sending. However, the banner will not instantly go away. Both a little bit of time and a refresh will be needed to clear the banner and regain the ability to reset the custom message limit. 

    Also remember that the customer message limit is per region. If you have domains in the US and EU regions, and want a custom message limit applied to all domains in both regions, you must set a custom message limit for each region.


    Implementing the solution

    We'll show you how to do this below:

    1. First, log in to the Mailgun Control Panel (if you have not already done so).
    2. Then, at the top-right corner of the page, click the Profile drop-down menu to expand its list of options.
    3. Also near the top of the page, click the Region drop-down menu to select the relevant region (if necessary)
    4. Next, click the Manage Account option. Alternatively, you can use this direct link
    5. On the resulting page within the Mailgun settings section, locate the Custom Message Limit setting.
    6. Upon clicking the Edit button, enter the numerical value for the desired message limit and click the Save button.


    Enabling the account

    To enable the account after a custom message limit disablement, you would go to the same location as mentioned in "Implementing the Solution". Here, you will click the green button to remove the disablement and the custom message limit. 


    Need Support?

    Our Support Team here at Sinch Mailgun is happy to help! Reach out to us in the Support section of your Mailgun Control Panel, and we'll be with you shortly!