Information for: DEVELOPERS   PARTNERS

Onboarding: Sender domains

Campaign Studio and Campaign Factory subscribers use the Campaign Factory interface to configure custom and sender domains. This applies to any subscribers using Campaign Studio’s email delivery service, Sparkpost. Subscribers using their own email delivery provider (including their own Sparkpost credentials) aren’t required to add a sender domain.

Understanding sender domains

A sender domain is the domain to send emails from, which comes after the @ in your From address. Email addresses you plan on using to send emails from in Campaign Studio must have the sender domain configured. This includes the primary email address you’ll use (default), different addresses for individual emails, and any Contact Owner email addresses if you plan on using the Mailer is owner feature.

A single Campaign Studio instance may be configured to send from more than one sender domain, and a single sender domain may be used across several Campaign Studio instances.

Campaign Studio requires proper configuration of sender domains. This is critical to help recipient mail servers authenticate your messages. Without proper authentication, your messages may end up in spam folders, if they’re delivered at all.

Using free email services

If you’re using Sparkpost to send your emails, you must use your company’s domain. Sparkpost requires senders to add records to the domain name server (DNS) manager, and Campaign Studio users don’t have access to the DNS manager for free domains like gmail.com, @yahoo.com, etc.

You may send emails from the same domain you use for your company’s G Suite account. Creating a domain for your G Suite account is like the process for configuring a sender domain in Campaign Studio.

Other email delivery services may allow users to use free domains. For information on using other email delivery providers, see Configuring your own email transport.

Creating a sender domain

Configure your sender domains on maestro.mautic.com.

  1. Sign in to your account.

  2. Navigate to the administration panel.

  3. Click the Settings wheel in the left panel.

  4. Click Domains.

  5. Click Create to add a new sender domain. The Create a new Sender Domain dialog box displays.

  6. Enter the following information:

    • Sender Domain: Enter one domain name. You can create more, but you must create each domain one at a time.

    • Bounce Domain: If left empty, Campaign Factory fills the field with bounces.senderdomain. You can add a custom bounce domain here. The bounce domain overrides the default return-path header in your emails. Recipient email service providers can check the return path (or Envelope FROM) header matches the sending domain.

    • Tracking Domain: If left empty, Campaign Factory fills the field with clicks.senderdomain.

    • Default From Email Name: The name Campaign Studio defaults to in the From field. Each email in Campaign Studio is customizable, if you want to use a different name.

    • Default From Email address: The email address Campaign Studio defaults to in the From field.

      Note

      Setting defaults for the From name and From address applies these settings to new instances created in an account using this sender domain. Check the instance configuration to ensure the name and address are properly configured.

  7. Click Save.

Note

If you use custom values for the bounce or tracking domains, contact Acquia support. Your Customer Success Manager must make a change in the system.

The newly created sender domain displays in a list.

Adding sender domains to instances

After the domain is created, attach it to an instance to enable emails sending from that domain.

  1. Go to the sender domain page.
  2. Click the Select Action menu.
  3. Click Assign to instance(s).
  4. Click Go.
  5. In the Assign to instance(s) dialog box, select one or more instances to assign this domain to.
  6. Click Run action.

Assigning or removing a domain from an account will attach or detach the domain from all instances within a Campaign Factory account. Assigning or removing from instances will attach or detach the domain from selected instances.

DNS records for a sender domain

To add records for your sender domain, you’ll need access to your Domain Name Server. Your website or domain manager can assist you.

In the list of sender domains, red dots indicate the DNS record hasn’t been validated. All three records must validate before you can use the sender domain. Once validated, the red dots will turn green.

To find the records, click the sender domain. You may see a message like:

One moment as we provision this domain. Please check back in a minute.

This message means Campaign Studio is connecting with Sparkpost to ensure it’s a domain it can create. If the message displays for more than 15 minutes, contact Acquia support for help.

Follow the instructions on the Sender Domain Details screen to add records to your DNS manager, or copy the information and supply it to the DNS administrator.

The three records are:

  • Sender domain
    • Type: TXT
    • Hostname: host123._domainkey.domain Copy and paste from your screen.
    • Value: Each value is unique, copy and paste from your screen.
  • Bounce Domain
    • Type: CNAME
    • Hostname: bounces.domain Copy and paste from your screen.
    • Value: sparkpostmail.com
  • Tracking domain
    • Type: CNAME
    • Hostname: clicks.domain Copy and paste from your screen.
    • Value: spgo.io

Note

Some DNS managers, including GoDaddy, append the .domain to new records. If yours does, add host123._domainkey, bounces, and clicks, respectively.

DNS records may take minutes to hours for to propagate. If you’re still seeing red after 24 hours, use a tool like dnschecker.org to see if the internet has accepted your record change. If it takes that long your configuration may be wrong.

After the records validate, the record values disappear and the red dots turn green.