Create, setup and manage sending domains with MailOut

This how-to describes how-to create a sending domain and setup and authorized sender. This tasks are prerequisites for sending emails with MailOut.

Prerequisites

• You have a STACKIT customer account: Create a customer account
• You have a STACKIT user account: Create a user account
• You have a STACKIT project: Create a project

Create, list, view and delete a sending domain

Create a sending domain

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Messaging > MailOut.
3. On the top bar, click on Create sending domain.
4. On the popup, enter the desired domain and click on Create.
5. After the sending domain has been created and it’s status has changed to Validating…, proceed with setting up the DNS records (see “Validate your sending domain”).

List all sending domains

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Messaging > MailOut.
3. You see a list of all sending domains with their state.

View/edit a sending domain

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Messaging > MailOut.
3. Navigate to the sending domain you want to view/edit and click on the entry in the list.

Delete a sending domain

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Messaging > MailOut.
3. Navigate to the sending domain you want to delete and click Delete on the three-dots-menu.
4. On the new pane, enter the domain name and confirm with Delete.

Setup a sending domain

To setup a sending domain, you need to verify your DNS configuration and create an authorized sender. Read the Basics of MailOut, why this is necessary.

Validate your sending domain

1. In the sending domain overview, click on the sending domain you want to validate.

2. In the menu on the left, click the DNS Configuration entry.

3. On the new pane, you see a list of DNS records that must be transferred to the DNS service of your domain hoster.

   You can either transfer the information manually OR by downloading the created zone file and uploading it at the destination DNS service.

   Use the correct DNS record type TXT and CNAME. Mandatory DNS records are DKIM, SPF and DMARC. Return path and MX records are optional.

4. After you added the DNS records to the DNS service, click Validate DNS records

Once validated correctly, you must be able to see a valid state for the DNS records in the overview of the sending domain. The overall state of your sending domain will turn from state “Validating…” to “Active”.

The DNS entries are regularly checked for validity and accuracy. Don’t delete or alter the entries after the initial validation, as submitted emails will be rejected if the entries are no longer correct.

Setup and authorized sender

To be able to send email messages using the SMTP endpoint, you need to create an authorized sender.

1. In the sending domain overview, click on the sending domain you want to create an Authorized Sender for.

2. In the menu on the left, click the Authorized Sender entry.

3. On the new pane on Create Authorized Sender.

4. In the modal dialog, enter a description for your Authorized Sender.

5. After you clicked Create, you will see all information for your Authorized Sender like username, password and SMTP endpoint.

   The password cannot be retrieved later.