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

Bulk Email Validations

Article Preview


    Need a simple, efficient method to perform email validations on a large scale quickly? Welcome to Bulk Validations!

    Our Bulk Validation feature provides a simple, easy-to-follow set of steps for validating a large number of email addresses and retrieving the results quickly. From there, you can take proactive steps to protect the reputations of your sending domain(s) and your assigned IPs by removing the invalid email addresses from your mailing lists or contacts. This due diligence, in turn, aids in maintaining an excellent quality of recipients, as well as minimizing bounce and suppression events. We're all about optimizing your sending to help enable the full range of your success!


    How to use the Bulk Validation API and retrieve the results

    If utilizing the Bulk Validations feature via the Email Validations API, the steps are as follows:

    1. Create a mailing list and upload members; take note of its alias.
    2. Submit a POST to the API URL which contains the alias from step 1 (more on this step below).
    3. Periodically submit a GET to the same URL to retrieve the download links for the CSV and JSON files.

    If utilizing the Control Panel, 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, within the left-hand navigation pane, click the Sending option to expand its list of suboptions.
    3. Next, click the Mailing lists suboption and select the intended mailing list.
    4. In the Details section and next to the Validate recipient addresses setting, click the Begin validation button and confirm the intention to perform the validation by clicking Begin

    Keep in mind - these validations take some processing time! You'll see the display demonstrating the validations as being in progress. Once complete, just click the Download validations result button.


    API endpoints

    POST - API command used to Submit Job  

    URL: https://api.mailgun.net/v3/lists/listalias@yourdomainhere.tld/validate

    GET - API command used to Gather Job Status

    URL: https://api.mailgun.net/v3/lists/listalias@yourdomainhere.tld/validate

    DELETE - API command used to Cancel Job

    URL: https://api.mailgun.net/v3/lists/listalias@yourdomainhere.tld/validate


    Things to keep in mind

    For successful implementation with your particular use case, make sure to remember the following:

    • Only one job can be processed per account at any given time
    • The processing rate of lists can vary depending on list size and system load


    Features & highlights

    In summary, here's the of options Bulk Validations provides for you:

    • Perform a list-based validation much faster than can be done one-by-one
    • Both CSV and JSON versions of processed email addresses available
    • Perpetually retrievable and parseable
    • Only three new simple sets of APIs that anyone already oriented with Mailgun's architecture can quickly and readily adopt
    • Existing Mailing Lists uploaded to your Mailgun account are readily able to use - right away


    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!