{"id":122967,"date":"2020-06-22T18:54:00","date_gmt":"2020-06-22T18:54:00","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/mailster-gmail-integration\/"},"modified":"2026-10-15T13:05:54","modified_gmt":"2026-10-15T13:05:54","slug":"mailster-gmail","status":"publish","type":"plugin","link":"https:\/\/jv.wordpress.org\/plugins\/mailster-gmail\/","author":15233756,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.0.0","stable_tag":"2.0.0","tested":"7.1.3","requires":"6.0","requires_php":"8.1","requires_plugins":null,"header_name":"Mailster Gmail Integration","header_author":"EverPress","header_description":"Uses Gmail to deliver emails for the Mailster Newsletter Plugin for WordPress.","assets_banners_color":"a7ddf2","last_updated":"2026-10-15 13:05:54","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/mailster.co\/?utm_campaign=wporg&utm_source=wordpress.org&utm_medium=plugin&utm_term=Gmail","header_author_uri":"https:\/\/mailster.co","rating":1,"author_block_rating":0,"active_installs":1000,"downloads":21943,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"everpress","date":"2022-12-01 16:12:54","revision":2827154},"1.1":{"tag":"1.1","author":"everpress","date":"2022-01-28 15:41:42","revision":2668318},"1.2":{"tag":"1.2","author":"everpress","date":"2022-12-01 17:04:14","revision":2827195},"1.3.0":{"tag":"1.3.0","author":"everpress","date":"2022-12-05 09:13:02","revision":2828585},"1.3.1":{"tag":"1.3.1","author":"everpress","date":"2024-05-27 13:13:52","revision":3093230},"2.0.0":{"tag":"2.0.0","author":"everpress","date":"2026-10-15 13:05:54","revision":3748544}},"upgrade_notice":[],"ratings":{"1":"1","2":0,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3748507,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3748507,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3748507,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3748507,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.2","1.3.0","1.3.1","2.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2747261,"resolution":"1","location":"assets","locale":"","width":1832,"height":716}},"screenshots":[]},"plugin_section":[],"plugin_tags":[267,897,150,132234,455],"plugin_category":[41,42],"plugin_contributors":[132235,228138,165179],"plugin_business_model":[],"class_list":["post-122967","plugin","type-plugin","status-publish","hentry","plugin_tags-email","plugin_tags-gmail","plugin_tags-google","plugin_tags-mailster","plugin_tags-newsletter","plugin_category-communication","plugin_category-contact-forms","plugin_contributors-everpress","plugin_contributors-mailster","plugin_contributors-xaverb","plugin_committers-everpress","plugin_support_reps-laurhelpdesk"],"banners":{"banner":"https:\/\/ps.w.org\/mailster-gmail\/assets\/banner-772x250.png?rev=3748507","banner_2x":"https:\/\/ps.w.org\/mailster-gmail\/assets\/banner-1544x500.png?rev=3748507","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/mailster-gmail\/assets\/icon-128x128.png?rev=3748507","icon_2x":"https:\/\/ps.w.org\/mailster-gmail\/assets\/icon-256x256.png?rev=3748507","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/mailster-gmail\/assets\/screenshot-1.png?rev=2747261","caption":""}],"raw_content":"<!--section=description-->\n<p><strong>Mailster Gmail Integration<\/strong> adds Gmail as a delivery method for the <a href=\"https:\/\/mailster.co\/?utm_campaign=wporg&amp;utm_source=wordpress.org&amp;utm_medium=readme&amp;utm_term=Gmail\">Mailster Newsletter Plugin for WordPress<\/a>. Campaigns are sent through the <a href=\"https:\/\/developers.google.com\/workspace\/gmail\/api\/guides\/sending\">Gmail API<\/a> from the Google account you authorize.<\/p>\n\n<p>Use it when you want Mailster to send from a Gmail address instead of your host\u2019s mail server. You connect a Google Cloud OAuth client, authorize the account once, and Mailster uses that mailbox for delivery.<\/p>\n\n<blockquote>\n  <p>This plugin requires <a href=\"https:\/\/mailster.co\/?utm_campaign=wporg&amp;utm_source=wordpress.org&amp;utm_medium=readme&amp;utm_term=Gmail\">Mailster<\/a> <strong>2.4.11<\/strong> or newer, PHP <strong>8.1<\/strong> or newer, and a Google account. You create an OAuth Client ID in Google Cloud (this is not an API key). Newsletter content is sent to Google through the Gmail API. The plugin requests the <code>https:\/\/mail.google.com\/<\/code> scope so it can send mail and read bounce messages in that mailbox. Gmail applies its own sending limits; Mailster\u2019s guide notes that Gmail is a weak fit for large marketing lists.<\/p>\n<\/blockquote>\n\n<h4>Send Mailster campaigns with Gmail<\/h4>\n\n<ul>\n<li><strong>Gmail delivery method<\/strong> \u2014 Choose Gmail under <strong>Newsletter \u2192 Settings \u2192 Delivery<\/strong>.<\/li>\n<li><strong>Google OAuth<\/strong> \u2014 Enter the OAuth Client ID and Client Secret, then authorize the Google account. The settings screen shows the redirect URI to paste into the Google Cloud client.<\/li>\n<li><strong>Sending address<\/strong> \u2014 After authorization, saving settings copies the connected Gmail address into Mailster\u2019s From, Reply-To, and Bounce fields.<\/li>\n<li><strong>Gmail API sending<\/strong> \u2014 Mailster messages are sent with <code>users.messages.send<\/code> for the authorized user. Mailster\u2019s own DKIM signing is turned off for these sends because Gmail handles authentication.<\/li>\n<li><strong>Bounce handling<\/strong> \u2014 The addon checks that Gmail mailbox for delivery failures and \u201cplease remove me\u201d replies, then unsubscribes or bounces the matching Mailster subscriber and removes those messages.<\/li>\n<li><strong>Redirect URL filter<\/strong> \u2014 Developers can change the OAuth redirect with the <code>mailster_gmail_redirect_url<\/code> filter.<\/li>\n<\/ul>\n\n<h4>How it works<\/h4>\n\n<ol>\n<li>Install and activate <strong>Mailster Gmail Integration<\/strong> next to Mailster 2.4.11+.<\/li>\n<li>In Google Cloud, enable the Gmail API and create an OAuth client (Web application). Add the redirect URI shown in Mailster\u2019s Gmail settings.<\/li>\n<li>Open <strong>Newsletter \u2192 Settings \u2192 Delivery<\/strong>, select <strong>Gmail<\/strong>, paste the Client ID and Client Secret, and save.<\/li>\n<li>Click <strong>Authorize<\/strong>, allow access in Google, and return to Mailster.<\/li>\n<li>Send a test email, then send Mailster campaigns through Gmail.<\/li>\n<\/ol>\n\n<p>Setup walkthrough: <a href=\"https:\/\/kb.mailster.co\/send-your-newsletters-via-gmail?utm_campaign=wporg&amp;utm_source=Gmail&amp;utm_medium=readme\">Send your newsletters via Gmail<\/a>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the entire <code>mailster-gmail<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory, or install it from the WordPress plugins screen.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu in WordPress.<\/li>\n<li>Make sure <a href=\"https:\/\/mailster.co\/?utm_campaign=wporg&amp;utm_source=wordpress.org&amp;utm_medium=readme&amp;utm_term=Gmail\">Mailster<\/a> 2.4.11 or newer is installed and active.<\/li>\n<li>In <a href=\"https:\/\/console.cloud.google.com\/\">Google Cloud<\/a>, enable the Gmail API, configure the OAuth consent screen, and create a Web application OAuth client. Add the Authorized redirect URI from Mailster\u2019s Gmail settings.<\/li>\n<li>Go to <strong>Newsletter \u2192 Settings \u2192 Delivery<\/strong>, open the <strong>Gmail<\/strong> tab, enter the Client ID and Client Secret, and save.<\/li>\n<li>Click <strong>Authorize<\/strong>, grant access to the Google account, and send a test email.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20work%20without%20mailster%3F\"><h3>Does this plugin work without Mailster?<\/h3><\/dt>\n<dd><p>No. This is a delivery addon for the <a href=\"https:\/\/mailster.co\/?utm_campaign=wporg&amp;utm_source=wordpress.org&amp;utm_medium=readme&amp;utm_term=Gmail\">Mailster Newsletter Plugin<\/a>. It requires Mailster <strong>2.4.11<\/strong> or newer.<\/p><\/dd>\n<dt id=\"do%20i%20paste%20a%20gmail%20api%20key%3F\"><h3>Do I paste a Gmail API key?<\/h3><\/dt>\n<dd><p>No. Gmail delivery uses a Google OAuth <strong>Client ID<\/strong> and <strong>Client Secret<\/strong> from a Google Cloud project, then an <strong>Authorize<\/strong> step so Mailster can send as that account. The setup guide walks through the OAuth client and redirect URI: <a href=\"https:\/\/kb.mailster.co\/send-your-newsletters-via-gmail?utm_campaign=wporg&amp;utm_source=Gmail&amp;utm_medium=readme\">Send your newsletters via Gmail<\/a>.<\/p><\/dd>\n<dt id=\"which%20address%20do%20newsletters%20come%20from%3F\"><h3>Which address do newsletters come from?<\/h3><\/dt>\n<dd><p>The Gmail address you authorize. When you save delivery settings while connected, Mailster\u2019s From, Reply-To, and Bounce addresses are set to that account\u2019s email address.<\/p><\/dd>\n<dt id=\"is%20email%20sent%20to%20google%3F\"><h3>Is email sent to Google?<\/h3><\/dt>\n<dd><p>Yes. With Gmail selected as the delivery method, Mailster sends the message through the Gmail API. The OAuth consent screen requests <code>https:\/\/mail.google.com\/<\/code> so the addon can send mail and look in that mailbox for bounces.<\/p><\/dd>\n<dt id=\"does%20it%20handle%20bounces%3F\"><h3>Does it handle bounces?<\/h3><\/dt>\n<dd><p>Yes, for mail sent with this addon. It searches the connected Gmail inbox and spam for mail-delivery failures and list-unsubscribe replies, matches Mailster\u2019s campaign headers, updates the subscriber, and deletes those messages from the mailbox.<\/p><\/dd>\n<dt id=\"what%20if%20google%20asks%20me%20to%20reconnect%3F\"><h3>What if Google asks me to reconnect?<\/h3><\/dt>\n<dd><p>If Gmail rejects the saved token, the addon clears the connection and shows a notice. Open <strong>Newsletter \u2192 Settings \u2192 Delivery<\/strong>, check the Gmail tab, and authorize again.<\/p><\/dd>\n<dt id=\"can%20i%20change%20the%20oauth%20redirect%20url%3F\"><h3>Can I change the OAuth redirect URL?<\/h3><\/dt>\n<dd><p>The settings screen shows the redirect URI to register in Google Cloud. Developers can replace it with the <code>mailster_gmail_redirect_url<\/code> filter. The value in Google Cloud must match the URL Mailster uses.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>changed: requires PHP 8.1 or newer<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>fixed: composer packages with PHP 8.0+<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>fixed: issue with third party library on PHP 8.0+<\/li>\n<li>added: <code>mailster_gmail_redirect_url<\/code> filter for redirect URL<\/li>\n<li>requires now PHP 7.4+<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Fixed some typo and updated method<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Update for Mailster 3.0<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>initial release<\/li>\n<\/ul>","raw_excerpt":"Deliver Mailster newsletters from a Gmail account using Google OAuth and the Gmail API.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/122967","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=122967"}],"author":[{"embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/everpress"}],"wp:attachment":[{"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=122967"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=122967"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=122967"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=122967"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=122967"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=122967"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}