SMTPRelay Documentation

What does SMTPRelay do?

SMTPRelay allows you to use any SMTP server from your Salesforce org. Salesforce does not support authenticated smtp relay servers. To make this work, you would have to have an open relay for the IP-ranges of Salesforce. This is not always a possibility.

Why would I want to use my own mail server?

The most common reason are to improve email deliverability and control. Sometimes emails sent by Salesforce end up in the junkmail folder, and there’s nothing you can do about it. You might want all email to go through a thirdparty email server, which can add open-tracking.

How does it work?

SMTPRelay trusts the Salesforce mail-servers, and send the emails using the email server you provide. This can be anything, e.g. your own smtp server, sendgrid, mailgun, authsmtp or amazon ses. These email services have excellent deliverability and a great support team. Read more information about the technical details.

Getting started

First off, you’ll need to register for an account. You won’t need your creditcard until the 14-day trial ends. After you’ve signed up, and activated your account, go to the control panel.

For configuration for specific smtp services, check the following guides:

Configuration

To configure SMTPRelay, you will first need to gather some information. This is:

  • The Salesforce organization ID
  • Your email server settings: smtp-server, username, password

It is advised to use a separate username/password for sending emails from Salesforce. This makes it easier to administrate. Please check your email-service if this is possible.

You can find the orgId by logging in to salesforce. Its under Setup, Company Profile, Company Information. It’s the 15-character code under Salesforce.com Organization ID.

salesforce orgid

In the SMTPRelay control panel, add a new organization. You will be asked to fill in the organization ID, a descriptive name of your org and the smtp settings.

After you’ve added the organization, SMTPRelay will check the credentials. If all is good it should be marked active.

Salesforce settings

Now that you’ve added the organization and the smtp-settings are checked, you can configure Salesforce to send email through SMTPRelay.

In Salesforce, go to Setup, Email Administration, Email Relay Activation. Enter the following:

relay-settings

  • Email Host: relay.getsmtprelay.com
  • Port: 587
  • Set TLS Setting to: Required
  • Uncheck “Restrict Relay To Domains”
  • Check Active

Click save.

Still in Salesforce, go to Setup, Email Administration, Deliverabiliy. Uncheck the following options:

  • Uncheck “Activate bounce management”
  • Uncheck “Enable compliance with standard email security mechanisms”

Finally, click save.

Emails will now be sent through SMTPRelay and your smtp-server. You should test this by sending a test email from Salesforce.