@bztes/strapi-provider-email-gmail-api

4.0.3 • Public • Published

strapi-provider-email-gmail-api

Yet another Strapi email provider for Gmail using OAuth 2.0 ;)

Installation

It's required to install this package with a different alias so that it belongs to the @strapi scope.

# npm
npm i @strapi/provider-email-gmail-api@npm:@bztes/strapi-provider-email-gmail-api

# or yarn
yarn add @strapi/provider-email-gmail-api@npm:@bztes/strapi-provider-email-gmail-api

The package.json should then contain:

  "dependencies": {
    "@strapi/provider-email-gmail-api": "npm:@bztes/strapi-provider-email-gmail-api@^4.0.0",
  }

Preparing Google API

Enable the Gmail API with OAuth authentication in 5 steps

Create a new Project

  1. Open the Google Console
  2. Create a new Project

Enable Gmail API

  1. In the Google Console select 'APIs & Services' -> 'Library'
  2. Search for 'Gmail' and click on enable

Configure OAuth consent screen

  1. In the Google Console select 'APIs & Services' -> 'OAuth consent screen'
  2. Select User Type 'Internal'
  3. Provide an App name and email address and click on 'save and continue'
  4. Click on 'add or remove scope'
  5. Select 'Gmail API .../auth/gmail.send' and click on 'update' and then 'save and continue'

Add Credentials

  1. In the Google Console select 'APIs & Services' -> 'Credentials'
  2. Select 'create credentials' -> 'OAuth client ID'
  3. Select 'Web application' and provide a name
  4. For 'Authorized redirect URIs' add 'https://developers.google.com/oauthplayground'
  5. Click on 'create'
  6. Take the 'Client ID' and 'Client Secret'

Connect a Gmail account

  1. Open the Google OAuth 2.0 Playground
  2. Click on settings and select 'Use your own OAuth credentials'
  3. Enter your 'Client ID' and 'Client Secret' and click on 'close'
  4. In Step 1 select 'Gmail API v1' -> '.../gmail.send' and click on 'Authorize APIs'
  5. Authorize with your Gmail Account you want to send mails from
  6. In Step 2 click on 'Exchange authorization code for tokens'
  7. Click on Step 2 and take the 'Refresh Token'

Provider Configuration

Variable Type Description Required Default
provider string The name of this provider 'google' yes
providerOptions object Provider options yes
providerOptions.auth.userId string The mail address of the Google account to send e-mails from yes
providerOptions.auth.clientId string OAuth 2.0 Client ID yes
providerOptions.auth.clientSecret string OAuth 2.0 Client Secret yes
providerOptions.auth.refreshToken string OAuth 2.0 Refresh Token yes
settings object Settings yes
settings.defaultFrom string Default sender mail address no
settings.defaultReplyTo string The receiver is asked to reply to no

Provider Configuration Example

config/plugins.js

module.exports = ({ env }) => ({
  email: {
    config: {
      provider: 'gmail-api',
      providerOptions: {
        auth: {
          userId: env('EMAIL_OAUTH2_USERID'),
          clientId: env('EMAIL_OAUTH2_CLIENTID'),
          clientSecret: env('EMAIL_OAUTH2_CLIENTSECRET'),
          refreshToken: env('EMAIL_OAUTH2_REFRESHTOKEN'),
        },
      },
      settings: {
        defaultFrom: env('EMAIL_FROM'),
        defaultReplyTo: env('EMAIL_REPLYTO'),
        testAddress: env('EMAIL_TEST_ADDRESS'),
      },
    },
  },
});

.env

EMAIL_FROM=Example Inc. <foo@my-domain.com>
EMAIL_REPLYTO=Example Inc. <foo@my-domain.com>
EMAIL_TEST_ADDRESS=foo@my-domain.com
EMAIL_OAUTH2_USERID=foo@my-domain.com
EMAIL_OAUTH2_CLIENTID=123....321.apps.googleusercontent.com
EMAIL_OAUTH2_CLIENTSECRET=ABC123...
EMAIL_OAUTH2_REFRESHTOKEN=1//123XYZ...

Resources

Package Sidebar

Install

npm i @bztes/strapi-provider-email-gmail-api

Weekly Downloads

59

Version

4.0.3

License

ISC

Unpacked Size

10.6 kB

Total Files

10

Last publish

Collaborators

  • bztes