Jump toUpdate content

Transactional Email - Quickstart

Published on 07 November 2022

Transactional Email is a platform that allows Scaleway clients to send transactional emails with high quality deliverability.

In this quickstart, we show you how to configure your domain with Transactional Email, how to add SPF, DKIM and MX records to your domain, and how to delete your domain.

Identity and Access Management (IAM):

If you have activated IAM, you may need certain IAM permissions to carry out some actions described on this page. This means:

  • you are the Owner of the Scaleway Organization in which the actions will be carried out, or
  • you are an IAM user of the Organization, with a policy granting you the necessary permission sets
Requirements:
  • You have an account and are logged into the Scaleway console.
  • You have a domain name.

How to configure your domain with Transactional Email

  1. Click Transactional Email in the Managed Services section of the console side menu. The Transactional Email overview page displays.
  2. Click Add a Domain.
  3. Enter the domain name you want to use with Transactional Email.
  4. Click Validate domain name to confirm.
Important:

You need to configure your SPF, DKIM and MX records to verify your domain and to be able to send emails.

How to add SPF and DKIM records to your domain

After you have configured your domain with Transactional Email, you are prompted to verify your domain by adding SPF, DKIM and MX records. You can choose to do so right after you have validated your domain, or at a later time.

  1. Click Transactional Email in the Managed Services section of the console side menu. Your newly-added domain displays.
  2. Click your domain. You are redirected to the SPF, DKIM and MX configuration page.
  3. Copy the value that applies to your case to add an SPF record.
  4. Add a TXT type record in the root zone of your domain on your DNS zone.
  5. Paste the value you have copied in the root zone of your domain.
  6. Add an additional TXT type record in the root zone of your domain on your DNS zone.
  7. Copy the name that displays in the console.
  8. Paste the name you have copied in the root zone of your domain on your DNS zone.
  9. Copy the value that displays in the console and paste it the root zone of your domain on your DNS zone.
  10. Check the box “I have added these DNS records to my DNS zone” to confirm.
  11. Click Verify your domain. Your domain displays in the list of your domains.
Note:

The verification of your domain can take up to 48 hours.

How to add an MX record to your domain

  1. Add an MX record type in the root zone of your domain on your DNS zone.
  2. Enter a name of your choice in the Name field.
  3. Set a priority for your MX record.
    Note:

    Priority indicates the order in which your mail servers should be tried by a mail server that is attempting to deliver emails.

  4. Enter a hostname of your choice in the Hostname field.
    Tip:

    If you do not wish to receive emails on your domain, you can add a null MX record:

    • Add an MX record type in the root zone of your domain on your DNS zone.
    • Enter . in the Name zone
    • Set the priority to 0.
  5. Save your changes.

How to delete your domain

  1. Click Transactional Email in the Managed Services section of the console side menu. The list of your domains displays.
  2. Click the domain you want to delete. The overview of your domain displays.
  3. Scroll down the page and click Delete domain.
    Important:

    This action will permanently delete your domain. All the domain’s information will be deleted, including your email activity.

  4. Type DELETE to confirm.
  5. Click Delete this domain to delete your domain.
Important:

If you have emails under “processing” status, they will be sent even if you delete your domain.