​This how-to provides initial steps for configuring Acquia Platform Email. 

In order to configure Platform Email, certain permissions are required. Below are the required roles for enabling Acquia Platform Email in the Acquia Cloud User Interface. 

Required Roles for Enabling Platform Email in the Cloud UI

Step 1: User registers a domain.

• Only admins and organization owners can perform this action.
• There is no explicit permission, since admins always inherit the ability to do everything.

Step 2: User associates a domain to an individual application.

• Organization owners and admins can perform this action.

Step 3: Enable Platform Email.

• Organization owners and admins can perform this action.

Enabling Platform Email in the Cloud UI¶

Below are the steps for enabling Acquia Platform Email in the Cloud UI.

1. First, enter the custom domain(s) from which you wish to send email.

a. Log in to Cloud UI. Navigate to any of your applications.

b. Enter the custom domain from which you will send email.

Enablement Tip: Platform Email allows configuration of a subdomain. However, it does not support configuration of a subdomain with the 'www' prefix. 

 

 

2. Take the DNS record generated for each domain to your DNS provider.

a. The system will generate unique DNS records for each domain. Give those to your DNS provider.

b. After no more than 72 hours, the DNS provider will communicate your ownership status to Acquia. You can verify the status (when it is returned) on this same page. 

 

 

3. Associate each domain to each application that will use it.

a. Because you can have many domains across a subscription, the next step is to associate each domain to the specific application which will use it.

Enablement Tip: A common issue during this step is failing to give the system time needed for your associated email to propagate. If you do not see the appropriate verified domain during this step, please ensure you have given your DNS provider up to 72 hours to verify ownership. 

 

 

4. Configure the “From” address in Drupal

a. Must enable Drupal to send notifications using a designated “From” address

b. Configuration→ Basic Site Settings→ Site Details

Enablement Tip: Ensure that the application email send-from address exactly matches what has been verified. If the send-from address does not match the verified domain, you will be unable to send emails.

5. Start sending email from the new service.

a. When you’re ready, cut over each environment to the new service by clicking the “enable” button on each environment’s Configuration screen.

 

Resources¶

• Platform Email
• Configuring Platform Email
• Troubleshooting Platform Email
• Legacy Email Retirement FAQ
• Acquia Support
• Publishing an MX record for Amazon SES email receiving