This article is for a feature to allow you connect a gmail account using OAuth which let's you more easily connect gmail accounts.

If you're looking for how to connect a gmail account using an app password, this is the article you're looking for:

https://help.supersend.io/en/articles/6928134-adding-a-gmail-gsuite-account


Google has recently become a lot more aggressive about the allowed types of applications that use the Gmail API. With this set up, you'll be able to (with some configuration) create up to 100 email senders in Super Send.

Go to google cloud's oauth consent screen. https://console.cloud.google.com/apis/credentials/consent?referrer=search



select the internal user type. Or you can create an external app and leave it in test mode.

Test Mode / External = you have to manually enter (on the google side) which emails are allowed to use this authentication. You are allowed up to 100.
Internal = anyone with an email for your domain will be allowed to connect their gmail account to Super Send.

Add supersend.io as the authorized domain.



Set the scopes as follows

you'll need to Manually add scopes and enter in `https://www.googleapis.com/auth/gmail.modify`

and

`https://www.googleapis.com/auth/gmail.labels`

Your scope should look like this:



Now go to credentials



click create credentials and select OAuth client ID



Set your OAuth client ID form to look like this:

It's a Web Application

you can name it whatever you'd like

Authorized Javascript origins are

https://supersend.io

authorized redirect url is

https://supersend.io/oauth/google



Once you have reached this point. Click download JSON and you are nearly ready to upload it to Super Send!



The next step is to enable the gmail api here:

https://console.cloud.google.com/apis/api/gmail.googleapis.com/overview



Ok good job, that should be it on the Google side.

Now that you have this .json file. You need to upload it to Super Send. If you go to the admin page, and click on the Teams tab, you can upload this .json file to one or many teams. The reason they are separated by Teams is that many agencies use Teams to delineate between different customers.



The Edit button will open a dialog box that will allow you to upload your .json file.



Finally! All the setup is complete. When you go to add a Sender you will now have this button appear:



Clicking on this button will ask you for permissions to modify your gmail account. What's nice is that actually you are 100% in control. You can revoke access at any time for your entire organization with ease.

But now it's 10x easier to connect a gmail account

Be sure to send a test email to make sure everything is looking good!

Happy Sending!

Bonus:

Add Test Users:

If you want to add more email accounts with only 1 oauth setup you can make the app external.



add test users here:

Updated on: 22/11/2024