← Terug naar kennisbank E-MAIL

Gmail / Google Workspace e-mail koppelen aan WordPress

Je gebruikt Gmail (privé) of Google Workspace (zakelijk met eigen domein) en wilt dat WordPress die mailbox gebruikt om bestellingen, formulier-meldingen en notificaties te versturen. Google heeft sinds mei 2022 "Less Secure App Access" volledig uitgeschakeld — dus de oude "vul gewoon je Gmail-wachtwoord in"-methode werkt niet meer. Deze gids loopt de moderne OAuth-koppeling stap voor stap door, plus App Passwords als alternatief en Google Workspace SMTP Relay voor hoge volumes.

Waarom dit anders ligt dan bij andere e-mailservices

Bij een gewone NL-hoster (TransIP, Antagonist, Hostnet) installeer je een SMTP-plugin, vult host/poort/user/wachtwoord in, klaar. Bij Gmail/Workspace is het verhaal sinds 2022 anders:

  • Less Secure Apps Access is afgeschaft: vóór 2022 kon je gewoon SMTP authenticatie doen met je Gmail-wachtwoord. Sinds 30 mei 2022 niet meer — alleen OAuth of App Passwords werken.
  • App Passwords vereisen 2-stapsverificatie: als je 2FA niet aan hebt staan, kun je geen App Password aanmaken. Voor Workspace-tenants kan deze optie door de admin uitgeschakeld zijn.
  • OAuth via Gmail API is de aanbevolen methode — vergt een Google Cloud Console-project en eenmalige autorisatie.
  • Verzendlimiet: gewone Gmail (gratis) heeft 500 e-mails per 24u limiet, Google Workspace 2.000 per 24u. Daarboven schakelt Google de account tijdelijk uit.

Concreet: in 2026 voor een WordPress-site die mail moet versturen via Gmail/Workspace heb je in 90% van de gevallen WP Mail SMTP met Gmail OAuth nodig. Hieronder eerst de drie methoden, daarna de stappen voor de meest gebruikte.

Drie methoden — kies de juiste voor jouw situatie

Methode 1: WP Mail SMTP met Gmail OAuth (aanbevolen)

Modern, veilig, geen wachtwoord opgeslagen in WordPress. Vereist eenmalige Google Cloud Console-setup en autorisatie. Werkt voor zowel gratis Gmail als Google Workspace.

Wanneer kiezen: standaard situatie — gratis Gmail of Workspace-account, gemiddeld volume (< 500 e-mails per dag), één enkele website.

Methode 2: SMTP met App Password

Snellere setup dan OAuth, maar je moet 2-stapsverificatie aan hebben staan en een 16-teken app-password aanmaken.

Wanneer kiezen: snelle setup, je hebt al 2FA, of je beheert meerdere sites en OAuth-flow per site is te bewerkelijk.

Methode 3: Google Workspace SMTP Relay (alleen voor Workspace)

Voor websites die honderden tot duizenden e-mails per dag versturen vanuit een eigen domein dat in Google Workspace zit. Hogere limiet (10.000 per dag), geen authenticatie nodig — Google vertrouwt jouw server-IP.

Wanneer kiezen: Workspace-tenant met custom domein, transactionele systemen, eigen server met vast IP, hoge volumes.

De rest van dit artikel behandelt methode 1 (Gmail OAuth) als hoofdpad, methode 2 en 3 in kortere vorm.

Voorbereiding — wat je nodig hebt

  • Google-account met admin-rechten op de tenant (voor Workspace) of een gewone Gmail-account (voor privé).
  • WordPress-admin-toegang tot de site waarvoor je het koppelt.
  • WP Mail SMTP plugin — gratis versie heeft Gmail-mailer ingebouwd.
  • HTTPS op je WordPress-site — Google staat geen HTTP-redirects toe in OAuth.

Stap 1 — Google Cloud Project aanmaken

Open console.cloud.google.com en log in. Klik bovenaan op de project-selector → New Project.

  1. Project name: bv. WordPress Mailer - jouwsite.nl
  2. Organization: laat staan op je organisatie (of "No organization" voor een gratis Gmail-account)
  3. Klik Create
  4. Wacht tot het project klaar is en kies hem in de project-selector

Stap 2 — Gmail API activeren

  1. In het linker hamburger-menu: APIs & Services → Library
  2. Zoek op Gmail API
  3. Klik op het resultaat → Enable
  4. Wacht een paar seconden tot de API geactiveerd is

Voor een externe OAuth-app moet je eerst het "consent screen" instellen — dat is het scherm dat je later te zien krijgt bij autorisatie ("Wilt u WP Mail SMTP toegang geven tot uw Gmail?").

  1. APIs & Services → OAuth consent screen
  2. User type:
    • Internal als je Workspace-account hebt en de app alleen voor users in je organisatie is
    • External voor gewone Gmail of als je naar buiten je organisatie wilt
  3. Klik Create
  4. Vul de verplichte velden in:
    • App name: WordPress Mailer (of jouw site-naam)
    • User support email: jouw e-mail
    • Developer contact email: jouw e-mail
  5. Save and Continue
  6. Op de Scopes-pagina: voeg toe https://www.googleapis.com/auth/gmail.send (alleen "send", niet read)
  7. Save and Continue
  8. Bij Test users (als je External koos): voeg jouw eigen Gmail toe als test-user. Je app blijft "in testing" tot je 'm publiceert.
  9. Save and Continue tot het einde

Belangrijk over publishing: zolang je app op "Testing" staat, expireert het access-token elke 7 dagen en moet je opnieuw autoriseren. Voor productie publiceer je hem (vraagt geen Google-review aan voor "send only" scope, maar je moet wel het OAuth-scherm helemaal door).

Stap 4 — OAuth Client ID aanmaken

  1. APIs & Services → Credentials
  2. Klik + Create Credentials → OAuth client ID
  3. Application type: Web application
  4. Name: bv. "WP Mail SMTP - jouwsite.nl"
  5. Authorized redirect URIs: dit moet exact matchen met wat WP Mail SMTP gebruikt. De waarde verschilt per plugin, maar standaard is:
    https://connect.wpmailsmtp.com/google/
  6. Klik Create

Je krijgt nu een popup met twee waarden — kopieer ze direct naar je wachtwoord-manager:

Client ID:      123456789-abc...xyz.apps.googleusercontent.com
Client Secret:  GOCSPX-...

Stap 5 — WP Mail SMTP installeren en configureren

In WordPress: Plugins → Nieuwe plugin → "WP Mail SMTP" zoeken → Installeren → Activeren.

Ga naar WP Mail SMTP → Settings:

  1. From Email: het mailadres dat als afzender wordt getoond. Voor gratis Gmail moet dit hetzelfde zijn als de Gmail-account. Voor Workspace kan dit elke alias zijn die in de Workspace zit.
  2. From Name: bv. "Jouwsite Notificaties"
  3. Vink aan: Force From Email en Force From Name (anders overschrijven plugins als WooCommerce de waarden)
  4. Bij Mailer: kies Google / Gmail

Plak Client ID en Client Secret in de juiste velden. Klik Save Settings.

Boven aan verschijnt nu een knop "Allow plugin to send emails using your Google account". Klik daarop. Je wordt naar Google geleid om autorisatie te verlenen — kies de juiste Gmail-account en klik Allow. Daarna kom je terug op WordPress en zie je "Connected to Google".

Stap 6 — Test sturen

WP Mail SMTP heeft een Email Test-tab. Vul je eigen e-mailadres in en klik Send Email.

  • "Email sent successfully" + e-mail aangekomen → klaar.
  • Foutmelding → ga naar de troubleshooting-sectie hieronder.

Doe daarna ook een echte WordPress-test: vraag een wachtwoord-reset aan via je login-pagina. Dat triggert wp_mail() via de normale flow en bewijst dat de koppeling alle WordPress-e-mails dekt.

Methode 2 — SMTP met App Password

Snellere setup dan OAuth. Werkt voor gratis Gmail én Workspace, mits 2-stapsverificatie aan staat.

Stap A: 2-stapsverificatie activeren (als je dat nog niet hebt)

Ga naar myaccount.google.com/security2-Step Verification → activeer met telefoonnummer of authenticator-app.

Stap B: App Password genereren

Op dezelfde Security-pagina, scroll naar App Passwords (verschijnt alleen als 2FA aan staat).

  1. App: kies "Other (custom name)" → typ bv. "WordPress mailer"
  2. Klik Generate
  3. Kopieer het 16-teken wachtwoord (in 4 groepen van 4 tekens, bv. abcd efgh ijkl mnop) — spaties verwijderen bij invoeren

Stap C: WP Mail SMTP configuratie

Bij Mailer kies Other SMTP. Vul in:

SMTP Host:        smtp.gmail.com
Encryption:       TLS
SMTP Port:        587
Auto TLS:         Aan
Authentication:   Aan
SMTP Username:    jouw@gmail.com (of jouw@jouwdomein.nl voor Workspace)
SMTP Password:    <het 16-teken app-password, zonder spaties>

Save → Email Test draaien.

Workspace-admins let op: in Workspace kan App Passwords standaard uitgeschakeld zijn. Dit zet je aan via Admin Console → Security → Authentication → "Less secure apps and your Google Account" → wijzig de policy. Pas op: deze setting heet "Less Secure Apps" maar betreft eigenlijk App Passwords.

Methode 3 — Google Workspace SMTP Relay (high-volume)

Niet voor de gemiddelde site. Maar als je dagelijks 500-10.000 mails verstuurt vanuit een eigen domein dat in Google Workspace zit, is dit de schaalbare optie.

Hoe het werkt

Je server (vast IP) verbindt direct naar smtp-relay.gmail.com op port 587 of 465. Workspace vertrouwt verbindingen vanaf jouw IP via de SMTP Relay Service. Geen authenticatie per request, wel SPF die jouw IP toestaat.

Setup-overzicht

  1. Workspace Admin Console (admin.google.com) → Apps → Google Workspace → Gmail → Routing
  2. Scroll naar SMTP relay serviceAdd another
  3. Allowed senders: "Only addresses in my domains"
  4. Authentication: vink aan "Only accept mail from the specified IP addresses" en voer je server-IP in
  5. Encryption: vink aan "Require TLS encryption"
  6. Save
  7. Voeg jouw server-IP toe aan SPF van het verzendende domein:
    v=spf1 include:_spf.google.com ip4:1.2.3.4 ~all
  8. WP Mail SMTP → Other SMTP → Host smtp-relay.gmail.com, Port 587, Encryption TLS, Authentication: Uit

Pas op: deze methode vereist een vast publiek IP. Op shared hosting werkt het niet.

Troubleshooting — meest voorkomende fouten

"535 5.7.8 Username and Password not accepted"

Methode 2 (App Password) faalt. Drie checks:

  • Heb je 2-stapsverificatie aan? Anders kun je geen App Password genereren.
  • Spaties in het App Password verwijderd? Het wordt getoond als abcd efgh ijkl mnop maar je moet abcdefghijklmnop invullen.
  • Voor Workspace: heeft de admin App Passwords toegestaan?

"Error 400: redirect_uri_mismatch"

De Authorized redirect URI in Google Cloud Console matcht niet met wat WP Mail SMTP gebruikt. Kopieer de URI exact zoals WP Mail SMTP hem toont en plak die bij je OAuth Client.

"Error 403: access_denied"

Je app staat op "Testing" en je bent niet als Test User toegevoegd. Of je probeert te autoriseren met een Google-account die niet in de organisatie zit (bij Internal-app). Voeg jezelf toe als Test User of zet de app op "In production".

"Token expired" elke 7 dagen

App staat nog op "Testing". Refresh tokens van een Test-app expireren na 7 dagen. Publiceer de app: OAuth consent screen → "Publish App". Voor "send only" scope is geen Google-review nodig.

"This app isn't verified" waarschuwing

Tijdens autorisatie zie je een groot rood schild. Voor private gebruik niet erg — klik AdvancedGo to [app name] (unsafe). Voor productie kun je officiële verificatie aanvragen, maar voor "send only" scope is dat zelden nodig.

Berichten worden gemarkeerd als spam

Reputatie-probleem of ontbrekend authenticatie-record. Check:

  • SPF voor het verzendende domein: v=spf1 include:_spf.google.com ~all
  • DKIM voor Workspace: zet aan via Admin Console → Apps → Gmail → Authenticate email → Generate new record → DNS record toevoegen
  • DMARC-record: minstens v=DMARC1; p=none; rua=mailto:dmarc@jouwdomein.nl

Volledige uitleg in SPF, DKIM en DMARC instellen.

"Daily sending quota exceeded"

Je hebt de Gmail-limiet geraakt:

  • Gratis Gmail: 500 mails per 24u
  • Google Workspace: 2.000 mails per 24u (mailbox), 10.000 via SMTP Relay

Te hoog volume = wisselen naar transactional service (SendGrid, Mailgun, Postmark) of SMTP Relay.

Best practices voor productie-sites

  1. Gebruik een aparte Workspace-mailbox voor uitgaande site-mail, bijvoorbeeld noreply@jouwdomein.nl of website@jouwdomein.nl. Niet je persoonlijke mailbox.
  2. Reply-To instellen op een echt bewaakt adres in WordPress, zodat klant-replies niet verdwijnen in een no-reply zwart gat.
  3. Documenteer Project ID, Client ID en Secret in een wachtwoord-manager. Bij verlies = nieuwe app-registratie nodig.
  4. Publiceer de app na succesvolle test. Anders expireren tokens elke 7 dagen.
  5. Monitor het verzendvolume via Workspace Admin → Reports → Email log search. Voorkom dat je je dagelijkse limiet raakt zonder te merken.
  6. Stel SPF, DKIM en DMARC correct in — Google's reputatie helpt je deliverability, maar zonder authenticatie-records kunnen ontvangers nog steeds als spam markeren.

Wanneer is Gmail/Workspace NIET de juiste keuze?

Gmail is geweldig voor kleine sites. Maar er zijn scenario's waar je beter een dedicated transactional service gebruikt:

  • Hoge volumes (> 2.000 per dag) → Postmark, Mailgun, Amazon SES, SendGrid
  • Marketing-mailings (nieuwsbrieven) → Mailchimp, MailerLite — niet via je Gmail-account jagen, dat is tegen Google's TOS én slecht voor reputatie.
  • Hoog risico op blacklisting (publiek formulier zonder captcha) → een gescheiden transactional service voorkomt dat je hele Workspace-tenant wordt geblacklist.
  • Real-time delivery-tracking (bouncebacks, opens, clicks) → transactional services hebben veel betere logging dan Gmail.
  • Multiple sites op dezelfde Workspace → snel raak je de 2.000/dag-limiet wanneer je zelfde Workspace-mailbox voor 5 sites gebruikt.

Gmail vs Microsoft 365 — welke kies je?

Beide oplossingen werken vergelijkbaar (OAuth + WP Mail SMTP). Praktische verschillen:

  • Setup-complexiteit: Gmail iets eenvoudiger dankzij WP Mail SMTP's "Allow"-knop. Microsoft vereist meer kliks in Entra ID.
  • Deliverability: vergelijkbaar — beide grote spelers met goede reputatie.
  • Verzendlimieten: Workspace 2.000/dag, M365 10.000/dag (zonder relay) — M365 wint hier.
  • Kosten: vergelijkbaar bij standaard plannen (€6-7/user/maand).
  • Custom domain mail: beide ondersteunen het identiek.
  • Token-expiry: Google's "Testing"-app expireert na 7 dagen tot je publiceert. M365 secrets duren tot 2 jaar.

Voor de meeste NL MKB-sites is het een gelijkspel — kies wat je al gebruikt. Heb je nog geen e-mailprovider, dan is Gmail/Workspace voor 1-3 mailboxen vaak goedkoper en eenvoudiger; Microsoft 365 is sterker bij organisaties die ook Office en Teams nodig hebben. Voor de M365-versie van deze gids: Microsoft 365 e-mail koppelen aan WordPress.

Backup-plan voor als Gmail ooit uitvalt

WP Mail SMTP Pro heeft een feature "Backup connection" — als de primaire mailer faalt, schakelt hij automatisch over naar een tweede. Praktische combo:

  • Primair: Gmail/Workspace (jouw branded domein, perfect deliverability)
  • Backup: een transactional service zoals Brevo (300/dag gratis) — alleen als Gmail down is

Klanten merken dan niet dat er een storing is.

Snelle checklist als de mails plotseling stoppen

  1. WordPress error_log openen — staan er wp_mail()-fouten in?
  2. WP Mail SMTP → Email Test → loopt hij op een specifieke fout?
  3. Check of je app nog steeds op "Testing" staat (token expired na 7 dagen).
  4. Check OAuth consent — soms wordt access ingetrokken na een tenant-wijziging.
  5. Check of de mailbox nog bestaat en niet hernoemd/gemigreerd is.
  6. Check Google service status: google.com/appsstatus
  7. Check je dagelijkse verzendquota — overschrijding = 24u block.

Diepere uitleg over wanneer WordPress-mails niet aankomen: WordPress e-mails komen niet aan — oplossen.