Skip to content

IvaBoard launches on 13 November 2026. Buying opens on launch day.

Join the waitlist
Join the waitlist

Connect Mailgun

4 min read
Published
Updated
Topic
Email

Send emails to your users through the Mailgun API, using a domain you have verified in Mailgun. This page covers the steps that are specific to Mailgun, including bounce reports. Read Connect your email provider first for the steps that apply to every provider.

Who can use it

Only a workspace owner or admin can connect Mailgun. Other team members cannot open the Email providers page.

Get the details from Mailgun

  1. Verify the sending domain you want to use in Mailgun, for example mg.example.com.
  2. Open the domain page in Mailgun and note its region. It is either the United States or Europe.
  3. Copy your private API key from Mailgun.

Connect Mailgun in IvaBoard

  1. Open Email providers in your workspace settings.
  2. Under Email services, select Mailgun.
  3. Type a short name in Name, such as Acme Mailgun.
  4. Type the address your users see in From address. Mailgun must have verified it.
  5. Optional: type the name your users see beside the address in From name.
  6. Type the sending domain in Sending domain, such as mg.example.com.
  7. Choose the region shown on your Mailgun domain page in Mailgun region.
  8. Paste the private API key in Private API key.
  9. Select Connect provider.
Workspace settings menu with Email providers marked 1.
Provider list with Mailgun marked 2.
Mailgun connect form with Name, From address, From name, Sending domain and Mailgun region marked 3 to 7.
Mailgun connect form with Private API key and Connect provider marked 8 and 9.

IvaBoard saves the key securely. Afterwards the card shows at most its last 4 characters. The card shows Waiting for a check.

Note

IvaBoard refuses From addresses on its own domains.

Check the connection and send a test email

  1. Select Check connection on the Mailgun card.
  2. The result shows on the card within about a minute. If it does not, reload the page.
  3. Select Send a test email on the same card.
Lower part of the connection card, with Check connection marked 1 and bounce reports still off.
Lower part of the connection card, with Send a test email marked 3.

Send a test email appears after the check passes. The test email goes to your own verified address, not to your users. A provider that accepts the test has taken the message. That is not the same as the email reaching an inbox, so look in your inbox too.

When both pass, the card says "Ready. A product can choose this provider in its email sender settings."

Bounce reports

Bounce reports let Mailgun tell IvaBoard about two kinds of email. A permanent bounce means the address cannot receive email. A spam complaint means someone marked your email as spam. IvaBoard then stops sending email to that address from your workspace. Temporary problems are ignored.

Get the signing key in Mailgun

  1. Open Sending in Mailgun.
  2. Open Webhooks.
  3. Copy the HTTP webhook signing key.

Turn on bounce reports in IvaBoard

  1. Paste the HTTP webhook signing key in the Bounce reports part of the Mailgun card.
  2. Select Turn on bounce reports on the same card.
  3. Select Copy next to Webhook address.
Lower part of the connection card with bounce reports off: HTTP webhook signing key and Turn on bounce reports marked 1 and 2.
Bounce reports ready panel: Copy for the webhook address marked 3.
Important

IvaBoard shows the webhook address only once. Copy it before you leave the page. To get a new one later, select New address. The old address stops working at once.

Add the webhook in Mailgun

  1. Open the Webhooks page in Mailgun.
  2. Add the Webhook address as a webhook for bounces and spam complaints.

When a report arrives, the card shows Last report received with the time. If reports stop arriving, check that Mailgun has the latest webhook address.

Example

For example, Sam is an owner of the Acme Labs workspace. Sam connects Mailgun with the name Acme Mailgun, the From address [email protected] and the sending domain mg.example.com. The region is the United States. After Check connection and Send a test email pass, Sam turns on bounce reports, copies the webhook address, and adds it to Mailgun.

If something goes wrong

  • The card says "The provider’s key was not accepted." Copy the HTTP webhook signing key again, exactly as Mailgun shows it.
  • The card says "The provider refused the credential." Create a new private API key in Mailgun. Select Replace credential, paste the new key in Private API key, select Save new credential, and check the connection again.
  • The card says "The provider refused the From address." Verify the address or its domain in Mailgun. Or select Edit, change the From address, and check and test again.

More messages and fixes are in Troubleshooting email.

Save to list