Send Messages Using Google OAuth

When you create a mailbox, you have the option to either use our servers (by default) or specify custom outgoing settings. This article talks about using custom outgoing settings with Gmail using Google OAuth.

In this article

Reasons to Use OAuth

Using customized outgoing settings allows you to save all of your outgoing replies to Gmail/G Suite for archive or backup purposes. It's worth mentioning that if you go this route, you do not have to add Help Scout to your SPF record or set up DKIM records

Configure Connection Settings

Before authenticating, you'll want to ensure that you're logged into the Gmail account for your  mailbox address (e.g., support@domain.com). Google OAuth will not work with Google Groups addresses. 

1

Open the desired mailbox and head over to Mailbox SettingsConnection Settings.

2

Under the Sending Emails section, select the Use my custom outgoing (SMTP) settings option. Click on the Send with Gmail button, and then the Sign in with Google button.

3

Choose the Google account associated with your mailbox address or choose Use another account to sign in to Google as the mailbox address. Click the blue Allow button on the next screen to allow Help Scout to use that Gmail account to send email. 

4

The next page will take you back to Help Scout where you will have a Sending via... confirmation stating that your SMTP settings are properly set up. Don't forget to hit the blue Save Settings button.

You can disconnect from Google OAuth at anytime by clicking on the blue Disconnect link next to the Google icon.

Common Questions

Can I use my own server settings?
Absolutely. If you have access to your own mail server and would like to use custom settings, just plug in the appropriate information by clicking on the Send with other SMTP button. If you're using your own settings, replies sent via Help Scout will not be synced to your Sent folder. The Sent folder syncing only works when Gmail OAuth settings are in use. 

What happens if my custom connection fails momentarily, or for an extended amount of time?
Not to worry! First and foremost, we'll let you know if there's an issue. Your emails will still be sent as we default to our own mail server if we detect problems on your end.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still stuck? How can we help? How can we help?