This guide will take you through the necessary steps to use your own domain through Mailgun.
Adding a new domain
From the left-hand menu, click on “Send” to expand the submenu. Here click on “Sending” to expand the submenu, and proceed to “Domains”.
In the "Domains" section, click on "Add new domain" button at the top right corner to start configuring the domain for sending.
Add your domain name, region (we recommend using the continent that fits your respondents) and click “Add Domain”. Please copy the exact domain name that you enter here and deliver it to us later in process.
Configuring DNS settings
You will be forwarded to a page where you can get details on required DNS settings. Here you will also be able to verify that you have made those changes correctly. Please note, that depending on your domain host changes can take 24-48 hours.
To return to this page later, click “Send” on the left navigation bar expand the submenu. Then click on “Sending”, and finally “Overview”. You will then have returned to this same page.
It is very important that these DNS settings are verified. For example, the “Tracking records” are required so that Zeffi is able to effectively send reminders to your respondents.
Creating and retrieving the API-key
Next, move into the “Domain settings” to retrieve the apikey that is required for sending emails.
Click “Sending API Keys”.
Click “Add sending key”.
Fill in a name that you will recognize (For example “Zeffi sender”) and click “Create sending key”.
Retrieve the “Sending API Key”. This will not be available later.
Defining Roles in Mailgun
In Mailgun if you have purchased a lisence, you can set different roles for API keys to control the access and permissions. Here are the available roles:
- Admin:
- Full read/write access to all Mailgun features available via API endpoints.
- Can create and delete API keys and SMTP credentials.
- Can create, administer, and delete account users.
- Can edit account and billing details.
- Developer:
- Includes all permissions of the Support role.
- Can read/write almost all data.
- Can edit webhooks, routes, and domain settings.
- Suitable for API keys that need comprehensive access but do not require full administrative control.
- Support:
- Includes all permissions of the Analyst role.
- Can read most data.
- Can edit suppressions, mailing lists, members, and authorized recipients.
- Can open and comment on support tickets.
- Analyst:
- Read access to most data.
- Can only modify their own settings.
- Suitable for roles that require access to reporting features but do not need to make changes.
Each role has specific permissions, ensuring that users have the necessary access without compromising security. For more detailed information on Mailgun API key roles and their specific permissions, refer to Mailgun Help Center and Mailgun's official documentation (Mailgun Help) (Mailgun).
Sending the configuration information
Now you have completed all the steps required to send Zeffi email invitations from your own domain. Please ensure that all the DNS settings are confirmed, and then send us the Domain and the Sending API key to support@zef.fi.
If you have any feedback in relation to this PDF, or setting up the mailgun sender in general – please reach out to us at support@zef.fi.