Configure Email Domain

SaaS
Emails sent from the 3scale system to developers on your behalf are distributed by SendGrid. The configurations guidelines in this section allow the emails to come from one of your domains rather than from 3scale.
This feature is not available on Personal plan accounts.
After you have the email setup configured on your side, inform 3scale support (support@3scale.net) to complete the process. Just as for SSL certificates, we recommend you complete these steps as soon as possible.
email config figure

Step 1: Configure email domain

  1. Add a domain that is a CNAME to SendGrid. (Choose anything you like for the APIMAIL.YOURDOMAIN subdomain):
  2. APIMAIL.YOURDOMAIN.com CNAME u11705.wl206.sendgrid.net
  3. Add the following TXT record to YOURDOMAIN.com:
  4. v=spf1 include:u11705.wl206.sendgrid.net -all
    (Or add include:u11705.wl206.sendgrid.net to an existing record.)
  5. Add the domain keys to ensure email deliverability:
  6. s1._domainkey.YOURDOMAIN.com CNAME s1.domainkey.u11705.wl206.sendgrid.net
    s2._domainkey.YOURDOMAIN.com CNAME s2.domainkey.u11705.wl206.sendgrid.net
    o1.APIMAIL.YOURDOMAIN.com A 167.89.103.115

Step 2: Verify your DNS changes

Use the following DIG statements from the command line to verify that your DNS changes are correctly implemented:

dig cname APIMAIL.YOURDOMAIN.com
# should return "u11705.wl206.sendgrid.net"

dig cname s1._domainkey.YOURDOMAIN.com
# should return "s1.domainkey.u11705.wl206.sendgrid.net"

dig cname s2._domainkey.YOURDOMAIN.com
# should return "s2.domainkey.u11705.wl206.sendgrid.net"

dig a o1.APIMAIL.YOURDOMAIN.com
# should return "167.89.103.115"

dig txt YOURDOMAIN.com
# should return "v=spf1 include:u11705.wl206.sendgrid.net -all"

Step 3: Inform 3scale to finalize the email domain change

As the final step, inform 3scale support to initiate the email change with the following information:

  • Desired email address for outbound mail. The email address should be in the form of apicontact@YOURDOMAIN.com.
  • Entry that you used for APIMAIL.YOURDOMAIN.
  • Full company address (including country).
  • Contact phone number.