# SMTP Google Mail Integration

Google Mail requires OAUTH2 for authentication (for more information : [https://developers.google.com/gmail/imap/imap-smtp](https://developers.google.com/gmail/imap/imap-smtp)).

It requires several steps to configure.\
You will start at Google API's and Service:\
[https://console.developers.google.com/projectselector/apis/credentials](https://console.developers.google.com/projectselector/apis/credentials)

Setup Oauth Consent (if was not yet created), make an internal one:

![Create consent](SMTP-Google-Mail-Integration/create_consent.png)

Set the support emails, the application domain and save it.\
![Consent settings 1](SMTP-Google-Mail-Integration/consent_settings_1.png)\
![Consent settings 2](SMTP-Google-Mail-Integration/consent_settings_2.png)

Go to the Credentials menu and create new credentials, choose OAuth client ID: ![Create credentials](SMTP-Google-Mail-Integration/create_credentials.png)

Choose Web application:\
![Credential config](SMTP-Google-Mail-Integration/credential_config.png)

It is required to set up the Authorized Redirect URIs. You can domain (where your CrushFTP is available), or localhost. The URI needs to end with:

```
?command=register_google_mail_api
```

After Credentials are created copy the Client ID and Secret.

Now if your credentials are setup, and your redirect domains are configured, you can use the credentials in CrushFTP to get your google auth token and get access.\
**CrushFTP admin page url must match with the redirect url.** In our example: http<!-- -->://XXXXcrushftp.com\
In the Preferences -> General Settings -> SMTP Settings, at **username SMTP Server Username put your google email address. Then click "Get mail refresh token" to get the "SMTP Server Password"**. Put your client id and secret on the appeared form.\
![Oauth form](SMTP-Google-Mail-Integration/oauth_form.png)

If your domain is not verified you will get a warning message, click on Advanced and proceed further:

![Not verified domain](SMTP-Google-Mail-Integration/not_verified_domain.png)

Click on allow:

![Allow form](SMTP-Google-Mail-Integration/allow_form.png)

Once it is finished the "SMTP Server Password" input field will be filled with the refresh token.

![Smtp config](SMTP-Google-Mail-Integration/smtp_config.png)
