strapi-provider-email-gmail-2lo v3.5.1

strapi-provider-email-gmail-2lo

This package is an email provider for the headless CMS Strapi. You can use this provider to send mail programmatically with strapi-plugin-email.

This provider enables you to send email with the Gmail API using a 2-legged OAuth configuration, when using G Workspace.

Supported versions:

• v3.5.x (recommended)
• v3.x

Not having Google Workspace (previously G suite) will not work with this provider.

Installation

# using yarn
yarn add strapi-provider-email-gmail-2lo

# using npm
npm install strapi-provider-email-gmail-2lo --save

Setup

1) Enable the Gmail API 2) Configure the OAuth consent screen 3) Create a service account 4) Create a new Private key for your service account 5) Configure the provider in config/plugins

Enable the scope in G Workspace (required)

The following steps will authorize the right scope, to allow sending email with G Workspace: 1) Go to G Workspace admin dashboard > Security > API controls > Manage domain-wide delegation 2) Add an authorized client

• Client name: client_id
• Scopes: https://mail.google.com/ 3) Authorize

Example

Path - config/plugins.js

module.exports = ({ env }) => ({
  // ...
  email: {
    provider: 'gmail-2lo',
    providerOptions: {
      username: 'myemail@example.com',
      clientId: env('EMAIL_CLIENT_ID'),
      privateKey: env('EMAIL_PRIVATE_KEY').replace(/\\n/g, '\n'),
    },
    settings: {
      defaultFrom: 'myemail@example.com',
      defaultReplyTo: 'myemail@example.com',
    },
  },
  // ...
});

TIP: When using environment variables for your privateKey, as in the example above, include all the \n in you .env file, like so:

EMAIL_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nAbC...xYz\n-----END PRIVATE KEY-----\n"

Resources

• MIT License

Links

• Strapi website
• Strapi community on Slack
• Strapi news on Twitter