skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
kylebrodeur/wordpress-agent-kit57 installs

wp-gravity-smtp

Use when working with Gravity SMTP: installing, configuring, or troubleshooting WordPress transactional email delivery via SendGrid, Mailgun, Postmark, Brevo, SES, or custom SMTP. Critical: always verify version ≥ 2.1.5 to protect against CVE-2026-4020 which leaks API keys via unauthenticated REST endpoint.

How do I install this agent skill?

npx skills add https://github.com/kylebrodeur/wordpress-agent-kit --skill wp-gravity-smtp
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides instructions for managing Gravity SMTP on WordPress, focusing on version verification to mitigate security risks and secure credential handling via environment variables.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Gravity SMTP

WordPress transactional email routing and delivery tracking. Gravity SMTP replaces the unreliable default PHP mail() with direct API integration to your provider — SendGrid, Mailgun, Postmark, Brevo, Amazon SES, Microsoft 365, Google, or custom SMTP.

Required on Elite or Nonprofit Gravity Forms license.

When to use

  • Installing or updating Gravity SMTP
  • Configuring an email provider (SendGrid, Mailgun, Postmark, etc.)
  • Diagnosing failed email delivery or notification issues
  • Auditing credential storage (CVE-2026-4020 mitigation)
  • Setting up backup senders or delivery alerts
  • Verifying email logging in wp-admin

⚠️ CVE-2026-4020 — update immediately

Gravity SMTP ≤ 2.1.4 has an unauthenticated REST endpoint that exposes your mail provider API keys. Update to v2.1.5+ on every environment before any other work.

wp gf version gravitysmtp    # must be ≥ 2.1.5
wp gf update gravitysmtp     # update if needed

Official documentation

ResourceURL
Docs homehttps://docs.gravitysmtp.com/
Getting startedhttps://docs.gravitysmtp.com/getting-started/
Integrations guidehttps://docs.gravitysmtp.com/integrations/
User guideshttps://docs.gravitysmtp.com/user-guides/
FAQhttps://docs.gravitysmtp.com/faq/
Changelog / releaseshttps://www.gravityforms.com/gravity-smtp-changelog/
Product pagehttps://www.gravitysmtp.com/
Pricing (Elite required)https://www.gravityforms.com/pricing/

Supported providers

ProviderTypeAPI key source
SendGridAPIhttps://app.sendgrid.com/settings/api_keys
MailgunAPIhttps://app.mailgun.com/settings/api_security
PostmarkAPIhttps://account.postmarkapp.com/api_tokens
Brevo (Sendinblue)APIhttps://app.brevo.com/settings/keys/api
Amazon SESAPIAWS IAM console
Microsoft 365OAuthAzure portal
Google / GmailOAuthGoogle Cloud Console
Custom SMTPSMTPYour provider

Procedure

1) Install and immediately verify version

wp gf install gravitysmtp --activate

# IMMEDIATELY check — CVE-2026-4020
SMTP_VER=$(wp gf version gravitysmtp)
echo "Gravity SMTP: $SMTP_VER"
php -r "exit(version_compare('$SMTP_VER','2.1.5','>=') ? 0 : 1);" \
  || echo "❌ CRITICAL: Update to ≥ 2.1.5"

2) Credential isolation (required)

Store credentials in wp-config.php constants loaded from environment variables. Never store API keys in wp_options — even if CVE is patched, it's better practice.

// wp-config.php
define('GRAVITY_SMTP_SENDGRID_API_KEY', getenv('SENDGRID_API_KEY'));
define('GRAVITY_SMTP_FROM_EMAIL',       getenv('SMTP_FROM_EMAIL'));
define('GRAVITY_SMTP_FROM_NAME',        '<Site Name>');

Set the env var in WP Engine (Environment Variables in portal) or via .env locally.

3) Configure in wp-admin

Navigate to: Gravity SMTP (left sidebar) → Settings → choose your provider.

4) Test delivery

# Send a test email via WP-CLI
wp eval "wp_mail('test@example.com', 'Test', 'Gravity SMTP test');"

Check the email log at Gravity SMTP → Email Log.

5) CI/CD — check on every deploy

# In GitHub Actions post-deploy script or wp gf SCRIPT option:
wp gf version gravitysmtp

6) Backup sender + alerts

Configure in Gravity SMTP → Settings → Backup Sender — routes to a fallback if primary fails. Set up Gravity SMTP → Settings → Alerts to get notified on delivery failures.


Security checklist

# Check version
wp gf version gravitysmtp

# Verify API key is NOT stored in wp_options
wp option get gravitysmtp_sendgrid_api_key 2>/dev/null && \
  echo "⚠️  Key in DB — move to wp-config.php" || echo "✓ Not in wp_options"

References

  • wp-gravity-forms skill — Installing GF and add-ons via wp gf
  • CVE details: search CVE-2026-4020 on NVD or WPScan

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/kylebrodeur/wordpress-agent-kit/wp-gravity-smtp">View wp-gravity-smtp on skillZs</a>