Reach more of your audience with self-service custom return-path and Email Delivery

May 14, 2024 | 3 minute read
Allan Yeung
Principal Product Manager
Dickie LaFlamme
Senior Deliverability Specialist
Josh Nason
Senior Email Delivery Consultant
Text Size 100%:

We’re excited to announce the ability for email senders to self-configure a custom return-path for emails sent from Oracle Cloud Infrastructure (OCI) Email Delivery. Setting a custom return-path, such as, which aligns with the sending domain can improve sending reputation and improve email deliverability. In short, it helps you reach more of your audience. This capability is now available in all regions and Dedicated Regions.

With our self-service feature, senders can set up authentication and technical configuration and send their first message, without ever filing a service request. Combined with our newly released HTTP Send API feature, this feature makes following best practices with OCI Email Delivery even easier.

What are custom return-paths?

Every outbound message has a return-path email address in the header of a message. This address is used for communication between OCI Email Delivery and the receiving mailbox providers, such as Gmail, Yahoo, and business addresses, regarding any failure in delivery.

OCI Email Delivery has a default address used for every customer. However, we recommend that our customers configure their own custom return-path domain for various reasons including domain alignment for DMARC (domain-based message authentication, reporting, and conformance), a static address to enable provider allow listing, and enabling senders to build off their own sending reputation versus using a generic return-path.

Getting started quickly

Setting up a custom return-path for emails is quick and easy. For full details, you can read the documentation, but the following steps show the simplified version:

  1. Create a unique subdomain from your sending domain, such as <region>, or <region>
  2. In the Oracle Cloud Console, go to OCI Email Delivery and choose your email domain.
  3. Add a custom return-path, which is located on the domain details page.
  4. Follow the directions in the Console shown in Figure 1, and set up a CNAME record in your DNS.
Adding a custom return path in the Oracle Cloud Console
Figure 1. Adding a custom return-path in the Oracle Cloud Console

Automate with your preferred language

The software development kits (SDKs), OCI command line interface (CLI), and Terraform provider now support setting your custom return-path for email. You can now automate all actions to configure the custom return-path from the Oracle Cloud Console. You can use your preferred language from the supported languages of Python, Java, .NET, Go, TypeScript, Ruby, and PowerShell.

For more information on the CLI, SDK, and Terraform capabilities, view the email delivery API documentation for details on setting the custom return-path, and the OCI Developer Guide.

Improve your sender reputation today

To learn more about Oracle Cloud Infrastructure Email Delivery, see the following resources:

Allan Yeung

Principal Product Manager

Product Manager on the OCI Developer Platform team, focusing on Messaging, API Gateway, and API Management products

Dickie LaFlamme

Senior Deliverability Specialist

A Deliverability Geek by day and avid outdoor enthusiast..also by day. I work on OCI's Deliverability team for the Email Delivery product. I have many years of experience consulting with customers about their email programs and how to effectively deliver mail.

Josh Nason

Senior Email Delivery Consultant

An email marketing veteran of more than a decade, Josh came to Oracle through the acquisition of Dyn. He currently works on both the Dyn and OCI Email Delivery teams, both assisting customers with email delivery issues and helping keep the network clean.

Previous Post

Update on technical standards investments at Oracle: Oracle joins the NIST AI Safety Consortium

Luke Kowalski | 5 min read

Next Post

Instance Security now available in Oracle Cloud Guard

Ugi Urnuntogtokh | 4 min read