This add-on is operated by Mailgun Technologies, Inc.
Don't waste your budget on email addresses that don’t exist.
Mailgun Email Validation
Last updated August 06, 2018
Table of Contents
Mailgun Email Validation provides validation for email addresses submitted through forms such as newsletters, online registrations, and shopping carts.
See Mailgun’s acceptable use policy for more information on using email validation appropriately.
Provisioning the add-on
Your app must have the Mailgun add-on provisioned in order to provision Mailgun Email Validation.
You can provision Mailgun Email Validation from your app’s Resources tab in the Heroku Dashboard, or via the CLI:
A list of all plans available can be found here.
$ heroku addons:create mailgun-validations:<PLAN>
Validating email addresses
See the Mailgun user manual for full documentation of Mailgun Email Validation.
Using the jQuery Plugin
Mailgun provides a jQuery plugin you can use for front-end email validation. Remember to use your public Mailgun API key in publicly accessible code.
The following example demonstrates adding email validation to a web form:
$('jquery_selector').mailgun_validator({
api_key: 'public-api-key',
in_progress: in_progress_callback, // called when request is made to validator
success: success_callback, // called when validator has returned
error: validation_error, // called when an error reaching the validator has occured
});
Usage limits
Mailgun’s public and private API endpoints have different rates of validation. Both sets of endpoints have a burst per minute rate limit in place.
Private endpoints have no usage limit outside of the burst per minute rate. You should use private endpoints for email validation, provided your code is not publicly accessible. Otherwise, you should use public endpoints and your public API key, which is available in the My Account tab of your Mailgun control panel.
Removing the add-on
You can remove the add-on from the Heroku dashboard or with the CLI:
$ heroku addons:destroy mailgun-validations
Support
All Mailgun Email Validation support and runtime issues should be submitted via one of the Heroku Support channels. Any non-support related issues or product feedback is welcome at help@mailgun.com.