Mailgun

Mailgun integration allows you to send emails through this provider using Bloomreach Engagement’s standard emailing mechanism.

Setup process

1. Create a new Mailgun account.

📘

You can also use an existing Mailgun account, although we recommend setting up an account dedicated to Bloomreach Engagement. The reason is that once fully configured, Mailgun will send webhooks (with status updates) to Bloomreach Engagement for every email sent via the used account - which may have implications for both privacy and performance.

2. Verify your account .

3. Add New Domain and follow Mailgun steps to verify your domain and DNS.

This step is crucial to execute the full functioning of integration. Since this step is somewhat technical and you will need permissions for your domain registration, consult this with your technical staff if you are not sure what to do. Please be aware that it may take some time (usually up to an hour, but it could be much longer) for Mailgun to verify the DNS records fully.

4. In Mailgun, copy the domain name and API key from Settings → API Keys.

5. Add Mailgun integration.

In Bloomreach Engagement, go to Data and Assets > Integrations > Add new integration and select Mailgun. Enter the copied Domain name and API key.

🚧

Technical warning about re-using mail API key.

Bloomreach Engagement allows you to use the same mail API key in different integrations even in different projects. However, this practice is not recommended, because all integrations with the same API key will share just one mail provider webhook for tracking delivered campaign events.

Deleting any of these integrations with a shared API key will result in deletion of the webhook and therefore none of the given projects will have tracking of delivered campaign events.

6. If you do not select "Handle webhooks automatically", please copy given tracking hook URL.

To Mailgun: Webhooks → edit URL. Put the same URL in all of given fields.

You can now use Bloomreach Engagement campaigns to send signed emails from your own domains using Mailgun.

Find more information on webhook notification documentation and naming here.

📘

After Integrating with Mailgun, you can look at Default email settings in order to change it to your default email integration.