{"id":319950,"date":"2026-05-30T10:25:47","date_gmt":"2026-05-30T10:25:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/emerge-mail\/"},"modified":"2026-06-23T15:57:12","modified_gmt":"2026-06-23T15:57:12","slug":"emerge-mail","status":"publish","type":"plugin","link":"https:\/\/tr.wordpress.org\/plugins\/emerge-mail\/","author":18311397,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.5.0","stable_tag":"1.5.0","tested":"7.0","requires":"6.0","requires_php":"8.1","requires_plugins":null,"header_name":"Emerge Mail","header_author":"Redigit","header_description":"Self-contained OAuth-native mail for WordPress with direct Gmail and Outlook API delivery.","assets_banners_color":"696c72","last_updated":"2026-06-23 15:57:12","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/emerge.redigit.net\/","header_author_uri":"https:\/\/redigit.net\/","rating":5,"author_block_rating":0,"active_installs":0,"downloads":281,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"redigit","date":"2026-05-30 10:25:38"},"1.1.0":{"tag":"1.1.0","author":"redigit","date":"2026-06-05 11:43:18"},"1.2.0":{"tag":"1.2.0","author":"redigit","date":"2026-06-13 07:00:41"},"1.3.0":{"tag":"1.3.0","author":"redigit","date":"2026-06-17 02:16:02"},"1.4.0":{"tag":"1.4.0","author":"redigit","date":"2026-06-20 09:12:35"},"1.5.0":{"tag":"1.5.0","author":"redigit","date":"2026-06-23 15:57:12"}},"upgrade_notice":{"1.5.0":"<p>Adds bounce &amp; complaint tracking for Gmail, SendGrid, Mailgun, Brevo, and Amazon SES, with a new <code>emerge_mail_bounce_received<\/code> action for your own code. Stored options and cron jobs are renamed to the <code>emerge_mail_<\/code> prefix automatically \u2014 no settings or connections are lost. No action needed on upgrade.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3554620,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3554620,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3554620,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3554620,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.1.0","1.2.0","1.3.0","1.4.0","1.5.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Connections table with Active radio, per-row From email override, last-error column, Send test and Disconnect actions.","2":"Connect Gmail \/ Connect Microsoft buttons with provider logos.","3":"Sender settings: From name, Reply-To, Throttle connections, and From header options.","4":"Email Controls: opt-in suppression of WordPress core admin\/editor self-notifications.","5":"Activity Log: suppressed notifications, provider send errors, and recipient bounces in one table with type and severity filters.","6":"Bounce handling: one auto-detecting webhook URL for SendGrid \/ Mailgun \/ Brevo \/ SES, plus the Gmail Apps Script bridge.","7":"Site-wide admin notice surfaced when a connection has failed recently."}},"plugin_section":[],"plugin_tags":[897,2061,12451,6696,48586],"plugin_category":[38,41],"plugin_contributors":[265055],"plugin_business_model":[],"class_list":["post-319950","plugin","type-plugin","status-publish","hentry","plugin_tags-gmail","plugin_tags-oauth","plugin_tags-sendgrid","plugin_tags-smtp","plugin_tags-transactional-email","plugin_category-authentication","plugin_category-communication","plugin_contributors-redigit","plugin_committers-redigit"],"banners":{"banner":"https:\/\/ps.w.org\/emerge-mail\/assets\/banner-772x250.png?rev=3554620","banner_2x":"https:\/\/ps.w.org\/emerge-mail\/assets\/banner-1544x500.png?rev=3554620","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/emerge-mail\/assets\/icon-128x128.png?rev=3554620","icon_2x":"https:\/\/ps.w.org\/emerge-mail\/assets\/icon-256x256.png?rev=3554620","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Emerge Mail replaces SMTP plugins for transactional WordPress email. Connect one or more mail accounts and every <code>wp_mail()<\/code> call your site makes \u2014 password resets, comment notifications, WooCommerce receipts, contact-form submissions \u2014 is delivered through that account.<\/p>\n\n<p>Seven providers, one unified send path:<\/p>\n\n<ul>\n<li><strong>Gmail<\/strong> (OAuth) \u2014 sign in to your Google account; no SMTP password needed.<\/li>\n<li><strong>Microsoft 365 \/ Outlook<\/strong> (OAuth) \u2014 sign in to personal Outlook\/Hotmail\/Live or Microsoft 365 work\/school accounts.<\/li>\n<li><strong>SendGrid<\/strong> (API key) \u2014 paste a v3 API key with Mail Send permission.<\/li>\n<li><strong>Mailgun<\/strong> (API key) \u2014 paste a private API key, sending domain, and pick your region (US or EU).<\/li>\n<li><strong>Amazon SES<\/strong> (Sigv4) \u2014 paste an IAM access key + secret with <code>ses:SendEmail<\/code> permission. No AWS SDK dependency.<\/li>\n<li><strong>Brevo<\/strong> (API key) \u2014 paste a v3 API key.<\/li>\n<li><strong>Generic SMTP<\/strong> \u2014 host + port + encryption + username + password for any SMTP server (your own host, an SES SMTP endpoint, Postmark SMTP, Fastmail, mailcow, etc.).<\/li>\n<\/ul>\n\n<p>Because the From address is your own authenticated mailbox or verified sender, messages benefit from SPF, DKIM, and DMARC alignment that PHP's <code>mail()<\/code> function cannot provide. This typically results in dramatically better inbox placement than default WordPress mail.<\/p>\n\n<h4>Know exactly what bounced<\/h4>\n\n<p>Most SMTP plugins send and forget. Emerge Mail closes the loop \u2014 it captures <strong>bounces and spam complaints<\/strong> from your provider and records them right inside WordPress, so you can see which addresses are failing and stop mailing them.<\/p>\n\n<ul>\n<li><strong>Real-time bounce &amp; complaint reporting<\/strong> for SendGrid, Mailgun, Brevo, and Amazon SES. Paste one webhook URL into your provider's dashboard \u2014 Emerge Mail auto-detects which provider sent each event from its payload, so a single endpoint covers them all.<\/li>\n<li><strong>Gmail bounces too.<\/strong> Gmail can't push webhooks, so Emerge Mail ships a small Google Apps Script that reads \"Mail Delivery Subsystem\" messages from your mailbox and forwards them to the same endpoint. Setup takes about a minute and installs its own schedule.<\/li>\n<li><strong>Classified automatically<\/strong> as a hard bounce, soft bounce, or spam complaint, written to the Activity Log, and correlated back to the original message \u2014 recipient, subject, mailbox, and From all in one place.<\/li>\n<li><strong>Built for developers.<\/strong> Every bounce fires an <code>emerge_mail_bounce_received<\/code> action with a clean, uniform payload, so list-hygiene, auto-suppression, or CRM-sync code can react instantly. Set an <code>X-Emerge-Mail-Ref<\/code> header on a send and it's echoed straight back to you on the bounce \u2014 on any provider, whether the bounce arrived synchronously at send time or later by webhook.<\/li>\n<\/ul>\n\n<h4>Key features<\/h4>\n\n<ul>\n<li><strong>Seven providers<\/strong> (above), all sharing the same routing, failover, and From-email overrides.<\/li>\n<li><strong>Multiple connections per site<\/strong> with automatic failover. The Active connection sends first; if it fails, the next available connection is tried, with a 1-hour cooldown on failed connections. Mix-and-match across providers \u2014 e.g. SendGrid primary, an SMTP fallback, and a Gmail mailbox as the last-resort backup.<\/li>\n<li><strong>Optional connection throttle<\/strong>: rotate through all your connected accounts instead of hammering the Active one.<\/li>\n<li><strong>Per-connection From email override<\/strong> for verified send-as aliases \/ verified senders.<\/li>\n<li><strong>Configurable sender defaults<\/strong>: a custom From name and an opt-in \"Reply-To = admin email when sender differs\" setting.<\/li>\n<li><strong>Full <code>wp_mail<\/code> compatibility<\/strong>: To\/Cc\/Bcc (including from headers), HTML bodies, multipart alternative, attachments, custom headers, RFC 2822 address formats including comma-separated lists and quoted display names, non-UTF-8 charsets.<\/li>\n<li><strong>RFC 2047 encoding<\/strong> for non-ASCII subjects and display names.<\/li>\n<li><strong>One-click Send test<\/strong> button per connection.<\/li>\n<li><strong>Email Controls<\/strong> page: opt-in suppression of WordPress core self-notifications you don't want to receive (comment moderation, automatic updates, new-user registered, etc.) \u2014 recorded to the Activity Log instead.<\/li>\n<li><strong>Bounce &amp; complaint tracking<\/strong> across Gmail, SendGrid, Mailgun, Amazon SES, and Brevo \u2014 captured in real time via a single auto-detecting webhook (plus a Gmail Apps Script bridge), classified hard \/ soft \/ complaint, correlated to the original send, and exposed to your own code through the <code>emerge_mail_bounce_received<\/code> action.<\/li>\n<li><strong>Activity Log<\/strong> page: unified record of mail sent through your connections, suppressed notifications, provider send errors, and recipient bounces \u2014 with provider, type, and severity filters, Provider \/ Mailbox \/ From \/ Recipient columns, bulk delete, and automatic 10-day pruning.<\/li>\n<li><strong>Bounce classification<\/strong>: provider-specific error patterns map to a unified <code>send.bounce.*<\/code> \/ <code>send.error.*<\/code> taxonomy so per-recipient bounces are distinguished from transport outages across every provider.<\/li>\n<li><strong>Last-error visibility<\/strong> per connection and a site-wide admin notice on recent failures.<\/li>\n<li><strong>Automatic hourly token refresh<\/strong> for OAuth connections (Action Scheduler when available, WP-Cron fallback). API-key connections require no maintenance.<\/li>\n<li><strong>Safe fallback<\/strong> to default WordPress mail delivery on any failure \u2014 the plugin never blocks email.<\/li>\n<li><strong>Extensible via filters<\/strong>: cooldown, HTTP timeouts, token-refresh timing, MIME output, suppression catalog.<\/li>\n<\/ul>\n\n<h4>How it works<\/h4>\n\n<p>When you connect an account, the credentials (OAuth tokens, or your API key \/ SMTP password) are encrypted with a per-site key and stored as a WordPress option. From that point on, your site talks directly to the provider's API or SMTP endpoint; no third party sits in the send path.<\/p>\n\n<p>The plugin hooks <code>pre_wp_mail<\/code>. If at least one connection is active, the message is routed through it. If the provider returns an error \u2014 or if no connections are configured \u2014 WordPress's default mail delivery takes over transparently.<\/p>\n\n<h4>What this is not<\/h4>\n\n<ul>\n<li>Not a marketing or bulk email tool. No subscriber lists, no campaigns, no broadcasts.<\/li>\n<li>Not a shared-IP SMTP relay. Each site sends from its own connected accounts.<\/li>\n<li>Not a way to spoof arbitrary From addresses. The provider will reject anything that isn't an authorized sender on the connected account.<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>To deliver mail, Emerge Mail can communicate with up to eight external services depending on which providers you connect. By installing and using this plugin you agree to use of these services. Nothing is contacted until you connect at least one provider in the plugin settings \u2014 every external call below is gated on the corresponding connection existing.<\/p>\n\n<h4>1. Emerge OAuth service (emerge.redigit.net)<\/h4>\n\n<p><strong>What it is and what it's used for:<\/strong> A stateless OAuth proxy operated by the plugin author. It exists to broker the OAuth authorization handshake between your WordPress site and Google or Microsoft so the plugin can be authorized to send mail from your mailbox. The proxy holds the OAuth client secrets that Google and Microsoft would otherwise require every site to register individually.<\/p>\n\n<p><strong>What data is sent, when:<\/strong><\/p>\n\n<ul>\n<li>When you click <strong>Connect Gmail<\/strong> or <strong>Connect Microsoft<\/strong>, your browser is redirected to <code>https:\/\/emerge.redigit.net\/oauth\/{provider}\/authorize<\/code> with a PKCE code challenge and a state token generated by your site. No personal data is sent.<\/li>\n<li>When the provider redirects back, your site posts the authorization code and PKCE verifier to <code>https:\/\/emerge.redigit.net\/oauth\/{provider}\/token<\/code> to receive the access and refresh tokens. The tokens are returned directly to your site and stored locally, encrypted, in <code>wp_options<\/code>. The proxy does not persist them.<\/li>\n<li>When an access token nears expiry, your site posts the refresh token to <code>https:\/\/emerge.redigit.net\/oauth\/{provider}\/refresh<\/code> to obtain a new access token. Again, nothing is persisted on the proxy.<\/li>\n<li>No email content, recipient lists, or message metadata is ever sent to the proxy.<\/li>\n<\/ul>\n\n<p><strong>Terms and privacy:<\/strong><\/p>\n\n<ul>\n<li>Terms of Service: <a href=\"https:\/\/emerge.redigit.net\/terms-of-service\">https:\/\/emerge.redigit.net\/terms-of-service<\/a><\/li>\n<li>Privacy Policy: <a href=\"https:\/\/emerge.redigit.net\/privacy-policy\">https:\/\/emerge.redigit.net\/privacy-policy<\/a><\/li>\n<\/ul>\n\n<h4>2. Google APIs (Gmail)<\/h4>\n\n<p><strong>What it is and what it's used for:<\/strong> Used only when you connect a Gmail mailbox. Once authorized, the plugin sends every <code>wp_mail()<\/code> message directly to the Gmail API (<code>gmail.googleapis.com<\/code>) from your WordPress site. Periodically the plugin also calls the Google OAuth userinfo endpoint (<code>www.googleapis.com\/oauth2\/v2\/userinfo<\/code>) to verify the access token is still valid.<\/p>\n\n<p><strong>What data is sent, when:<\/strong><\/p>\n\n<ul>\n<li>On each <code>wp_mail()<\/code> call routed through a Gmail connection: the full outbound message (To\/Cc\/Bcc, subject, body, attachments, custom headers) is POSTed to <code>https:\/\/gmail.googleapis.com\/gmail\/v1\/users\/me\/messages\/send<\/code> as a base64-encoded RFC822 message. This is what's required for the message to reach the recipient.<\/li>\n<li>On token validation: a Bearer token is sent to <code>https:\/\/www.googleapis.com\/oauth2\/v2\/userinfo<\/code>. No message data is included.<\/li>\n<\/ul>\n\n<p><strong>Terms and privacy:<\/strong><\/p>\n\n<ul>\n<li>Google Terms of Service: <a href=\"https:\/\/policies.google.com\/terms\">https:\/\/policies.google.com\/terms<\/a><\/li>\n<li>Google Privacy Policy: <a href=\"https:\/\/policies.google.com\/privacy\">https:\/\/policies.google.com\/privacy<\/a><\/li>\n<li>Google API Services User Data Policy: <a href=\"https:\/\/developers.google.com\/terms\/api-services-user-data-policy\">https:\/\/developers.google.com\/terms\/api-services-user-data-policy<\/a><\/li>\n<\/ul>\n\n<h4>3. Microsoft Graph (Outlook \/ Microsoft 365)<\/h4>\n\n<p><strong>What it is and what it's used for:<\/strong> Used only when you connect a Microsoft mailbox. Once authorized, the plugin sends every <code>wp_mail()<\/code> message directly to Microsoft Graph (<code>graph.microsoft.com<\/code>) from your WordPress site. Periodically the plugin also calls Graph's <code>\/me<\/code> endpoint to verify the access token is still valid.<\/p>\n\n<p><strong>What data is sent, when:<\/strong><\/p>\n\n<ul>\n<li>On each <code>wp_mail()<\/code> call routed through a Microsoft connection: the full outbound message (To\/Cc\/Bcc, subject, body, attachments, custom headers) is POSTed to <code>https:\/\/graph.microsoft.com\/v1.0\/me\/sendMail<\/code> as a JSON payload. This is what's required for the message to reach the recipient.<\/li>\n<li>On token validation: a Bearer token is sent to <code>https:\/\/graph.microsoft.com\/v1.0\/me<\/code>. No message data is included.<\/li>\n<\/ul>\n\n<p><strong>Terms and privacy:<\/strong><\/p>\n\n<ul>\n<li>Microsoft Services Agreement: <a href=\"https:\/\/www.microsoft.com\/en\/servicesagreement\">https:\/\/www.microsoft.com\/en\/servicesagreement<\/a><\/li>\n<li>Microsoft Privacy Statement: <a href=\"https:\/\/privacy.microsoft.com\/en-us\/privacystatement\">https:\/\/privacy.microsoft.com\/en-us\/privacystatement<\/a><\/li>\n<\/ul>\n\n<h4>4. SendGrid (api.sendgrid.com)<\/h4>\n\n<p><strong>What it is and what it's used for:<\/strong> Used only when you add a SendGrid connection. The plugin sends every <code>wp_mail()<\/code> message routed through that connection directly to the SendGrid Mail Send API. The connect-time validation also calls SendGrid's <code>\/v3\/user\/profile<\/code> to confirm the API key works.<\/p>\n\n<p><strong>What data is sent, when:<\/strong><\/p>\n\n<ul>\n<li>On each <code>wp_mail()<\/code> call routed through a SendGrid connection: the outbound message (recipients, subject, body, attachments, custom headers) is POSTed to <code>https:\/\/api.sendgrid.com\/v3\/mail\/send<\/code> as a JSON payload.<\/li>\n<li>On connect: an authenticated GET is sent to <code>https:\/\/api.sendgrid.com\/v3\/user\/profile<\/code> to validate the API key. No message data is included.<\/li>\n<\/ul>\n\n<p><strong>Terms and privacy:<\/strong><\/p>\n\n<ul>\n<li>SendGrid Terms: <a href=\"https:\/\/www.twilio.com\/legal\/tos\">https:\/\/www.twilio.com\/legal\/tos<\/a><\/li>\n<li>SendGrid Privacy Statement: <a href=\"https:\/\/www.twilio.com\/legal\/privacy\">https:\/\/www.twilio.com\/legal\/privacy<\/a><\/li>\n<\/ul>\n\n<h4>5. Mailgun (api.mailgun.net or api.eu.mailgun.net)<\/h4>\n\n<p><strong>What it is and what it's used for:<\/strong> Used only when you add a Mailgun connection. The plugin sends every <code>wp_mail()<\/code> message routed through that connection directly to the Mailgun Messages API on the region (US or EU) you select at connect time.<\/p>\n\n<p><strong>What data is sent, when:<\/strong><\/p>\n\n<ul>\n<li>On each <code>wp_mail()<\/code> call routed through a Mailgun connection: the outbound message (recipients, subject, body, attachments, custom headers) is POSTed as multipart\/form-data to <code>https:\/\/api.mailgun.net\/v3\/{your-domain}\/messages<\/code> (or the EU equivalent).<\/li>\n<li>On connect: an authenticated GET is sent to <code>\/v3\/domains\/{your-domain}<\/code> to validate the API key + domain pairing. No message data is included.<\/li>\n<\/ul>\n\n<p><strong>Terms and privacy:<\/strong><\/p>\n\n<ul>\n<li>Mailgun Terms of Service: <a href=\"https:\/\/www.mailgun.com\/legal\/terms\/\">https:\/\/www.mailgun.com\/legal\/terms\/<\/a><\/li>\n<li>Mailgun Privacy Policy: <a href=\"https:\/\/www.mailgun.com\/legal\/privacy-policy\/\">https:\/\/www.mailgun.com\/legal\/privacy-policy\/<\/a><\/li>\n<\/ul>\n\n<h4>6. Amazon SES (email.{region}.amazonaws.com)<\/h4>\n\n<p><strong>What it is and what it's used for:<\/strong> Used only when you add an Amazon SES connection. The plugin sends every <code>wp_mail()<\/code> message routed through that connection directly to the SES v2 SendEmail API in the AWS region you select at connect time. Requests are signed with AWS Signature V4 using the IAM credentials you provided.<\/p>\n\n<p><strong>What data is sent, when:<\/strong><\/p>\n\n<ul>\n<li>On each <code>wp_mail()<\/code> call routed through a SES connection: the outbound message (recipients, subject, body, custom headers) is POSTed to <code>https:\/\/email.{region}.amazonaws.com\/v2\/email\/outbound-emails<\/code> as a JSON payload.<\/li>\n<li>On connect: a signed GET is sent to <code>\/v2\/email\/account<\/code> in the same region to validate the credentials. No message data is included.<\/li>\n<li>If you enable bounce handling for SES: when Amazon SNS posts its one-time subscription confirmation to your site's webhook endpoint, the plugin completes the handshake by sending a GET to the <code>SubscribeURL<\/code> that Amazon includes (validated to only ever request <code>amazonaws.com<\/code> hosts). No message data is included. Thereafter SNS posts bounce\/complaint notifications to your endpoint; the plugin does not initiate those.<\/li>\n<\/ul>\n\n<p><strong>Terms and privacy:<\/strong><\/p>\n\n<ul>\n<li>AWS Customer Agreement: <a href=\"https:\/\/aws.amazon.com\/agreement\/\">https:\/\/aws.amazon.com\/agreement\/<\/a><\/li>\n<li>AWS Privacy Notice: <a href=\"https:\/\/aws.amazon.com\/privacy\/\">https:\/\/aws.amazon.com\/privacy\/<\/a><\/li>\n<\/ul>\n\n<h4>7. Brevo (api.brevo.com)<\/h4>\n\n<p><strong>What it is and what it's used for:<\/strong> Used only when you add a Brevo connection. The plugin sends every <code>wp_mail()<\/code> message routed through that connection directly to the Brevo Transactional Email API.<\/p>\n\n<p><strong>What data is sent, when:<\/strong><\/p>\n\n<ul>\n<li>On each <code>wp_mail()<\/code> call routed through a Brevo connection: the outbound message (recipients, subject, body, attachments, custom headers) is POSTed to <code>https:\/\/api.brevo.com\/v3\/smtp\/email<\/code> as a JSON payload.<\/li>\n<li>On connect: an authenticated GET is sent to <code>https:\/\/api.brevo.com\/v3\/account<\/code> to validate the API key. No message data is included.<\/li>\n<\/ul>\n\n<p><strong>Terms and privacy:<\/strong><\/p>\n\n<ul>\n<li>Brevo Terms of Use: <a href=\"https:\/\/www.brevo.com\/legal\/termsofuse\/\">https:\/\/www.brevo.com\/legal\/termsofuse\/<\/a><\/li>\n<li>Brevo Privacy Policy: <a href=\"https:\/\/www.brevo.com\/legal\/privacypolicy\/\">https:\/\/www.brevo.com\/legal\/privacypolicy\/<\/a><\/li>\n<\/ul>\n\n<h4>8. Your own SMTP server (Generic SMTP)<\/h4>\n\n<p><strong>What it is and what it's used for:<\/strong> Used only when you add a Generic SMTP connection. The plugin opens an SMTP connection to whatever host:port you specify, authenticates with the username and password you provide, and sends <code>wp_mail()<\/code> messages via SMTP. WordPress's bundled PHPMailer library handles the SMTP protocol.<\/p>\n\n<p><strong>What data is sent, when:<\/strong><\/p>\n\n<ul>\n<li>On each <code>wp_mail()<\/code> call routed through this connection: the outbound message (recipients, subject, body, attachments, custom headers) is transmitted over SMTP to your configured host.<\/li>\n<li>On connect: PHPMailer opens the SMTP connection, runs EHLO + STARTTLS (if enabled), and authenticates \u2014 no message is sent.<\/li>\n<\/ul>\n\n<p><strong>Terms and privacy:<\/strong> Determined by whichever SMTP server you choose to connect to. This plugin does not introduce any third-party SMTP relay; you control the destination.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>emerge-mail<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install via the Plugins screen.<\/li>\n<li>Activate the plugin from the Plugins menu.<\/li>\n<li>Click the new <strong>Emerge Mail<\/strong> top-level item in your WordPress admin sidebar.<\/li>\n<li>Pick a provider and connect:\n\n<ul>\n<li><strong>Gmail \/ Microsoft<\/strong> \u2014 click <strong>Connect Gmail<\/strong> or <strong>Connect Microsoft<\/strong> and approve the OAuth consent screen.<\/li>\n<li><strong>SendGrid \/ Brevo<\/strong> \u2014 paste an API key with Mail Send permission and a verified From email.<\/li>\n<li><strong>Mailgun<\/strong> \u2014 paste your private API key, a verified sending domain, and pick your region (US or EU).<\/li>\n<li><strong>Amazon SES<\/strong> \u2014 paste an IAM access key + secret with <code>ses:SendEmail<\/code> permission and the region your SES identity is verified in.<\/li>\n<li><strong>Generic SMTP<\/strong> \u2014 paste host, port, encryption, username, and password.<\/li>\n<\/ul><\/li>\n<li>Click <strong>Send test<\/strong> on the new connection row to confirm delivery to your administrator email.<\/li>\n<\/ol>\n\n<p>As soon as a connection is active, <code>wp_mail()<\/code> routes through it automatically.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20work%20with%20woocommerce%2C%20contact%20form%207%2C%20wpforms%2C%20etc.%3F\"><h3>Does this work with WooCommerce, Contact Form 7, WPForms, etc.?<\/h3><\/dt>\n<dd><p>Yes. Anything that uses <code>wp_mail()<\/code> \u2014 which is virtually every WordPress plugin that sends email \u2014 works without modification.<\/p><\/dd>\n<dt id=\"do%20i%20need%20a%20google%20cloud%20or%20microsoft%20azure%20account%3F\"><h3>Do I need a Google Cloud or Microsoft Azure account?<\/h3><\/dt>\n<dd><p>No. Authorization is handled by the Emerge OAuth service. You sign in with your normal Google or Microsoft account; no developer setup is required.<\/p><\/dd>\n<dt id=\"how%20are%20my%20credentials%20stored%3F\"><h3>How are my credentials stored?<\/h3><\/dt>\n<dd><p>All credentials \u2014 OAuth tokens for Gmail and Microsoft, plus API keys and SMTP passwords for SendGrid, Mailgun, Amazon SES, Brevo, and Generic SMTP \u2014 are encrypted with a key generated locally on your site on first activation and stored as a WordPress option. They never leave your install. For OAuth, the proxy used during sign-in does not persist tokens.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20an%20oauth%20access%20token%20expires%3F\"><h3>What happens when an OAuth access token expires?<\/h3><\/dt>\n<dd><p>Access tokens expire roughly hourly. The plugin refreshes them automatically \u2014 both on a schedule and inline if a send happens to coincide with an expiry. You don't need to do anything. API-key connections (SendGrid, Mailgun, SES, Brevo, SMTP) don't expire \u2014 the credentials you paste are used as-is until you rotate them yourself.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20a%20provider%20is%20unreachable%3F\"><h3>What happens if a provider is unreachable?<\/h3><\/dt>\n<dd><p>The plugin returns an error from its <code>pre_wp_mail<\/code> hook, which causes WordPress to fall back to its default mail delivery (or to the next available connection if you have failover set up). The failure is recorded in the <strong>Last error<\/strong> column of the settings page and surfaced as an admin notice for 24 hours.<\/p><\/dd>\n<dt id=\"can%20i%20send%20from%20multiple%20accounts%3F\"><h3>Can I send from multiple accounts?<\/h3><\/dt>\n<dd><p>Yes. Connect as many as you like, mixing providers freely \u2014 e.g. a SendGrid account, a Gmail mailbox, and an SMTP server as a last-resort fallback. The connection marked <strong>Active<\/strong> is used first. If a send fails (or the Active connection is in cooldown after a recent error), the plugin automatically falls through to the next available connection. You can switch the Active account at any time from the Connections table.<\/p>\n\n<p>For high-volume sites, turn on <strong>Throttle connections<\/strong> in Sender settings to spread sends across all connected accounts instead of always hitting the Active one.<\/p><\/dd>\n<dt id=\"can%20i%20override%20the%20from%20email%3F\"><h3>Can I override the From email?<\/h3><\/dt>\n<dd><p>Yes. Enter a different address in the <strong>From email<\/strong> column on the Connections table. It must be a sender that the provider has authorized for this account \u2014 a verified send-as alias for Gmail\/Microsoft, a verified sender or domain for SendGrid \/ Mailgun \/ Amazon SES \/ Brevo, or whatever the SMTP server allows. Sends from an unauthorized address will be rejected by the provider.<\/p><\/dd>\n<dt id=\"can%20i%20customize%20the%20from%20display%20name%3F\"><h3>Can I customize the From display name?<\/h3><\/dt>\n<dd><p>Yes. Set it in <strong>Sender settings \u2192 From name<\/strong> on the main settings page. Leave it blank to use your site title as the default.<\/p><\/dd>\n<dt id=\"does%20emerge%20mail%20track%20bounces%20and%20spam%20complaints%3F\"><h3>Does Emerge Mail track bounces and spam complaints?<\/h3><\/dt>\n<dd><p>Yes. Open <strong>Emerge Mail \u2192 Email Settings \u2192 Bounce handling<\/strong>. For SendGrid, Mailgun, Brevo, and Amazon SES, copy the single webhook URL into your provider's event\/webhook settings (SES routes through an SNS topic subscription, which confirms itself automatically). One endpoint serves every provider \u2014 Emerge Mail detects which one sent each event from the payload. For Gmail, copy the included Google Apps Script into a new project at script.google.com and run its setup function once; it reads delivery-failure messages from the mailbox and forwards them to the same endpoint on a 15-minute schedule. Every bounce or complaint is classified (hard \/ soft \/ complaint) and recorded in the Activity Log, correlated back to the original message.<\/p><\/dd>\n<dt id=\"how%20do%20i%20act%20on%20a%20bounce%20from%20my%20own%20plugin%20or%20code%3F\"><h3>How do I act on a bounce from my own plugin or code?<\/h3><\/dt>\n<dd><p>Hook the <code>emerge_mail_bounce_received<\/code> action. It fires once per bounce or complaint \u2014 whether detected synchronously when the provider rejects a recipient at send time, or later via webhook \u2014 with a single, uniform payload: <code>email<\/code>, <code>disposition<\/code> (<code>hard<\/code> \/ <code>soft<\/code> \/ <code>complaint<\/code>), <code>type<\/code>, <code>subject<\/code>, <code>mailbox<\/code>, <code>from<\/code>, <code>provider<\/code>, <code>reason<\/code>, <code>message_id<\/code>, <code>client_ref<\/code>, and <code>source<\/code>. To tie a bounce back to your own records, set an <code>X-Emerge-Mail-Ref<\/code> header on the original <code>wp_mail()<\/code> call \u2014 its value is echoed back to you as <code>client_ref<\/code>, on every provider.<\/p><\/dd>\n<dt id=\"can%20i%20suppress%20noisy%20wordpress%20notifications%20i%20don%27t%20care%20about%3F\"><h3>Can I suppress noisy WordPress notifications I don't care about?<\/h3><\/dt>\n<dd><p>Yes. Open <strong>Emerge Mail \u2192 Email Controls<\/strong> and tick the notifications you want stopped. Eight WordPress core admin\/editor notifications are listed (comment moderation, new comments, password reset notices, new user registrations, and automatic-update results). Suppressed notifications are recorded in <strong>Emerge Mail \u2192 Activity Log<\/strong> so you still have an audit trail. End-user notifications (password resets, account changes, new-user welcome) are intentionally not listed \u2014 users need those.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20read%20my%20mailbox%3F\"><h3>Does the plugin read my mailbox?<\/h3><\/dt>\n<dd><p>No. For Gmail and Microsoft, the OAuth scope requested is sufficient only to send mail. The plugin does not call any read endpoints and cannot access existing messages. For SendGrid, Mailgun, SES, Brevo, and SMTP, the plugin only ever posts outbound messages \u2014 it does not request inbox reads, contact-list reads, or any other data from the provider.<\/p><\/dd>\n<dt id=\"is%20%60wp_mail%60%20still%20available%20to%20other%20plugins%20after%20activation%3F\"><h3>Is `wp_mail` still available to other plugins after activation?<\/h3><\/dt>\n<dd><p>Yes. <code>wp_mail<\/code> continues to function normally. The plugin only changes how the underlying send is performed; it doesn't change any of <code>wp_mail<\/code>'s public behavior.<\/p><\/dd>\n<dt id=\"will%20the%20plugin%20work%20without%20an%20active%20mailbox%20connection%3F\"><h3>Will the plugin work without an active mailbox connection?<\/h3><\/dt>\n<dd><p>Yes. <code>wp_mail<\/code> falls through to WordPress's default delivery when no connection is available. The plugin never blocks email.<\/p><\/dd>\n<dt id=\"how%20do%20i%20remove%20all%20stored%20data%20on%20uninstall%3F\"><h3>How do I remove all stored data on uninstall?<\/h3><\/dt>\n<dd><p>Deleting the plugin from the Plugins screen runs <code>uninstall.php<\/code>, which removes every stored connection, all encrypted tokens, the per-site encryption key, sender\/control settings, the bounce-webhook secret, the Activity Log table, and all scheduled jobs.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.5.0<\/h4>\n\n<ul>\n<li>New: bounce &amp; complaint tracking for SendGrid, Mailgun, Brevo, Amazon SES, and Gmail. A single REST endpoint detects the source from the payload, classifies each event as a hard\/soft bounce or complaint, records it in the Activity Log (correlated to the original send), and fires the <code>emerge_mail_bounce_received<\/code> action. Copy the URL from Email Settings \u2192 Bounce handling into your provider's dashboard (SES routes through an SNS topic subscription, confirmed automatically). Gmail, which can't push webhooks, uses a provided Google Apps Script that reads bounce messages from the mailbox and forwards them to the same endpoint.<\/li>\n<li>New: successful sends store the provider's message id on the log row (not shown as a column) so webhook bounces can map back to the send. Adds a 4th argument to the <code>emerge_mail_after_send_attempt<\/code> action.<\/li>\n<li>New: <code>emerge_mail_bounce_received<\/code> fires for synchronous (send-time) rejections as well as async webhooks, with one unified payload \u2014 recipient, disposition, type, subject, mailbox, From, provider, reason, and <code>client_ref<\/code>. Set an <code>X-Emerge-Mail-Ref<\/code> (or <code>Message-ID<\/code>) header on wp_mail() and it's echoed back as <code>client_ref<\/code> so you can map a bounce to your own record on any provider.<\/li>\n<li>Changed: \"Email Controls\" is now \"Email Settings\"; suppression checkboxes sit under a single \"Suppress WordPress Admin notifications\" heading.<\/li>\n<li>Changed: the daily usage report derives its counts from the Activity Log instead of a separate counter option (<code>emerge_usage_counters<\/code>), which is removed. Same data, same cadence.<\/li>\n<li>Changed: stored options and scheduled jobs renamed from the bare <code>emerge_<\/code> prefix to <code>emerge_mail_<\/code> (encryption key, connections, settings, webhook secret, cron hooks) to avoid namespace clashes with other plugins. Renamed in place on upgrade \u2014 no settings or connections lost.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>New: Activity Log unifies all mail activity \u2014 successful sends logged alongside suppressions, send errors, and bounces, with Provider\/Mailbox\/From columns and a provider filter.<\/li>\n<li>New: <code>emerge_mail_log_sends<\/code> filter to disable logging of successful sends.<\/li>\n<li>New: Reconnect on an Expired API-key connection re-validates the saved key in place and reactivates it if valid.<\/li>\n<li>Changed: \"Bulk sending\" renamed to \"Throttle connections\" \u2014 rotates across all mailboxes when on; burst detection removed.<\/li>\n<li>Changed: post-error connection cooldown raised from 10 minutes to 1 hour.<\/li>\n<li>Changed: default log retention lowered from 30 days to 10 days (<code>emerge_mail_log_retention_days<\/code>).<\/li>\n<li>Changed: send-error\/bounce logging and the bounce classifier are now standard; the <code>EMERGE_MAIL_PRO<\/code> gate is removed.<\/li>\n<li>Fix: a successful send (including Send test) clears a stuck \"Expired\" status back to \"Active\".<\/li>\n<li>Fix: the dashboard failure notice names the provider and auth type, so failures are unambiguous when connections share an email.<\/li>\n<li>Removed: the unsafe \"Other admin notices\" catch-all in Email Controls (it could suppress admin password resets).<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>New: SendGrid, Mailgun, Amazon SES (Sigv4, no AWS SDK), Brevo, and Generic SMTP (PHPMailer) providers.<\/li>\n<li>New: per-provider connect forms \u2014 credentials are validated against the provider before being persisted.<\/li>\n<li>Changed: failover and throttle mix-and-match freely across OAuth and API-key providers.<\/li>\n<li>Changed: bounce classifier extended with provider-specific patterns for all five new providers.<\/li>\n<li>Changed: token-refresh scheduler skips API-key connections; they're marked <code>expired<\/code> on 401\/403.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>New: Status column on the connections list (Active \/ Cooldown \/ Expired).<\/li>\n<li>New: Reconnect action on expired connections \u2014 re-runs OAuth and upserts tokens in place.<\/li>\n<li>Fix: settings form \"link expired\" error on sites also running Emerge Campaigns; admin handlers are now page-scoped.<\/li>\n<li>Changed: form-submit triggers and nonce actions renamed from <code>emerge_*<\/code> to <code>emerge_mail_*<\/code> to avoid collisions.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>New: \"Other admin notices\" catch-all suppression in Email Controls (<code>emerge_mail_suppress_other_admin<\/code> filter).<\/li>\n<li>New: unified Activity Log replaces the Suppression Log (suppressions, send errors, bounces in one table).<\/li>\n<li>New (pro): synchronous bounce detection and provider send-error logging (<code>send.bounce.*<\/code> \/ <code>send.error.*<\/code>).<\/li>\n<li>New: <code>emerge_mail_event_logged<\/code> and <code>emerge_mail_after_send_attempt<\/code> actions; pro gate via <code>EMERGE_MAIL_PRO<\/code>.<\/li>\n<li>Changed: <code>wp_mail()<\/code> return reflects failure type \u2014 transport errors fall back to default mail, recipient bounces return <code>false<\/code> (<code>emerge_mail_fallback_on_failure<\/code> filter).<\/li>\n<li>Changed: connection-failure admin notice scoped to Dashboard and Plugins screens.<\/li>\n<li>Schema: <code>emerge_suppression_log<\/code> renamed to <code>emerge_mail_event_log<\/code> with new columns; migrated in place.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>OAuth connections to Gmail and all Microsoft account types.<\/li>\n<li>Multiple mailboxes with active-first routing, automatic failover, and per-connection cooldown.<\/li>\n<li>Optional throttle that rotates connections, per-connection From override, configurable Sender settings.<\/li>\n<li>Full <code>wp_mail<\/code> mapping (attachments, Cc\/Bcc, multipart, address lists, non-UTF-8, RFC 2047).<\/li>\n<li>Send-test per connection; Email Controls page; Suppression Log with 30-day pruning.<\/li>\n<li>Hourly token maintenance (Action Scheduler \/ WP-Cron); safe fallback to default mail.<\/li>\n<li>Filter hooks for cooldown, HTTP timeouts, token refresh, MIME output, suppression catalog, and log retention.<\/li>\n<\/ul>","raw_excerpt":"Route wp_mail through Gmail, Microsoft, SendGrid, Mailgun, SES, Brevo, or any SMTP server. OAuth or API key, with failover and bounce tracking.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/319950","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=319950"}],"author":[{"embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/redigit"}],"wp:attachment":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=319950"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=319950"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=319950"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=319950"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=319950"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=319950"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}