gitlab-org--gitlab-foss/doc/administration/integration/mailgun.md

stage	group	info	type
Growth	Expansion	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments	reference, howto

Mailgun and GitLab (FREE SELF)

When you use Mailgun to send emails for your GitLab instance and Mailgun integration is enabled and configured in GitLab, you can receive their webhook for permanent invite email failures. To set up the integration, you must:

1. Configure your Mailgun domain.
2. Enable Mailgun integration.

After completing the integration, Mailgun permanent_failure webhooks are sent to your GitLab instance.

Configure your Mailgun domain

Before you can enable Mailgun in GitLab, set up your own Mailgun permanent failure endpoint to receive the webhooks.

Using the Mailgun webhook guide:

1. Add a webhook with the Event type set to Permanent Failure.
2. Fill in the URL of your instance and include the /-/members/mailgun/permanent_failures path.
   • Example: https://myinstance.gitlab.com/-/members/mailgun/permanent_failures

Enable Mailgun integration

After configuring your Mailgun domain for the permanent failures endpoint, you're ready to enable the Mailgun integration:

1. Sign in to GitLab as an Administrator user.
2. On the top bar, select Menu > {admin} Admin.
3. On the left sidebar, go to Settings > General and expand the Mailgun section.
4. Select the Enable Mailgun check box.
5. Enter the Mailgun HTTP webhook signing key as described in the Mailgun documentation and shown in the API security section for your Mailgun account.
6. Select Save changes.