Mailgun

Frontegg user management documentation

Portal Configuration

To configure Mailgun via the Frontegg portal, go to your [Environment]-> Emails -> Providers. Press connect and fill in the relevant details required by Mailgun. To integrate with Mailgun, you must fill in the values for the API key, and Domain name fields.

To obtain these values, go to your Mailgun dashboard -> API keys> API security -> Mailgun API keys.

🚧

API Keys

Note that when creating a new AP key, the value will only display once, so make sure you copy it and keep it somewhere safe yet accessible.

Mailgun API keys

Mailgun API keys


📘

Region

The Region field is mandatory, and you can choose between the Mailgun US or Mailgun EU regions, depending on the location of your account.


API Configuration

To configure your external email provider via API, you will need send a POST request to the https://{domain}.frontegg.com/identity/resources/mail/v2/configurations route with the mandatory fields filled with credentials from your Mailgun account.

To configure Mailgun specifically, you will need to send values for the secret,domain, and region fields. These fields are required to perform your API call. The secret in this case refers to the API key we already showed how to obtain in the Portal configuration section.

🚧

Prerequisites

  • A vendor token from the authentication route is required to use this API. Check out the Getting Started With Frontegg APIs topc to learn more.
  • Regions: note that you will need to fill in the region field when invoking the request— us should be used for US accounts, whereas eu should be for European acconts.

The domain value is located in the left-hand menu of your Mailgun dashboard. Go to the Send section. -> Sending -> Domains, as indicated below:

Domains can be copied from the left menu

Domains can be copied from the left menu