Comment connecter Gmail a n8n avec OAuth2
Chapitres
Résumé
Connecter Gmail à n8n via OAuth2 permet d'envoyer, recevoir et gérer des emails directement depuis vos workflows d'automatisation. Ce tutoriel détaille chaque étape de la configuration, depuis la création du projet Google Cloud jusqu'au test d'envoi d'un premier email.
Pourquoi OAuth2 pour Gmail dans n8n ?
L'authentification OAuth2 est la méthode recommandée par Google pour accéder aux API Gmail. Contrairement aux mots de passe d'application, OAuth2 offre un contrôle granulaire des permissions et respecte les standards de sécurité de Google Cloud. La procédure implique 4 phases : création d'un projet Google Cloud, activation des API, configuration de l'écran de consentement, et génération des identifiants Client ID / Client Secret.
Les 4 API Google utiles pour n8n
Dans Google Cloud Console, il est recommandé d'activer simultanément les 4 API Google les plus utilisées dans n8n : Gmail API pour les emails, Google Calendar API pour la gestion d'agenda, Google Drive API pour le stockage de fichiers, et Google Sheets API pour les tableurs. Google Sheets dépend de Google Drive - activer Sheets sans Drive provoque des erreurs. Les 4 API partagent les mêmes identifiants OAuth2, ce qui évite de répéter la procédure.
L'écran de consentement OAuth
L'écran de consentement est une étape obligatoire souvent oubliée. Il faut configurer le type "externe", renseigner le nom de l'application et l'email de contact, puis impérativement publier l'application dans la section Audience. Sans publication, la connexion échoue silencieusement. Cette étape unique suffit pour toutes les API du même projet.
Tester et réutiliser les credentials
Une fois le Client ID et le Client Secret collés dans n8n, le bouton "Sign in with Google" ouvre une fenêtre d'autorisation. Les cases de permissions déterminent les actions possibles dans les workflows. Pour connecter d'autres services Google (Calendar, Drive, Sheets), il suffit de créer un nouveau credential dans n8n avec les mêmes Client ID et Client Secret - pas besoin de recréer le projet ni les identifiants.
Guide de configuration Google OAuth2
Suivez les étapes pour connecter Gmail (et les autres services Google) à n8n via OAuth2.
Créer le credential dans n8n
n8n > Credentials > Create Credential- 1Rechercher "Gmail OAuth2 API"
- 2Copier l'OAuth Redirect URL (nécessaire à l'étape 5)
- 3Laisser Client ID et Client Secret vides pour l'instant
Contenu détaillé
00:00Introduction
Présentation du tutoriel : connecter Gmail à n8n via OAuth2 pour automatiser l'envoi et la gestion d'emails.
00:25Créer le credential Gmail dans n8n
Dans n8n, créer un nouveau credential de type Gmail OAuth2 API. Noter l'OAuth Redirect URL nécessaire pour Google Cloud.
01:10Accéder à Google Cloud Console
Depuis la documentation n8n, ouvrir Google Cloud Console. Cliquer sur Console en haut à droite pour accéder au tableau de bord.
01:45Créer un projet Google Cloud
Créer un nouveau projet dédié à n8n. Vérifier qu'il est bien sélectionné dans le sélecteur de projets après création.
02:30Activer les API Google
Dans API et services, activer Gmail API, Google Calendar API, Google Drive API et Google Sheets API. Drive est requis pour que Sheets fonctionne.
04:15Configurer l'écran de consentement
Renseigner le nom de l'application, l'email de contact, choisir le type externe. Étape critique : publier l'application dans la section Audience.
05:40Publier l'application
Dans Audience, cliquer sur Publier l'application et confirmer. Sans cette étape, la connexion OAuth2 échoue.
06:10Créer les identifiants OAuth2
Dans Identifiants, créer un ID client OAuth de type application web. Coller l'URI de redirection depuis n8n. Copier le Client ID et le Client Secret générés.
07:30Connecter n8n à Google
Coller Client ID et Client Secret dans le credential n8n. Cliquer sur Sign in with Google, sélectionner le compte et accorder les permissions.
08:30Tester l'envoi d'un email
Créer un workflow avec un noeud Gmail, configurer l'envoi d'un email de test. Vérifier la réception dans la boîte mail.
09:30Réutiliser pour d'autres services Google
Créer un credential Google Calendar avec les mêmes Client ID et Secret. La procédure est identique pour Drive et Sheets.
Questions fréquentes
Transcription complète
Pour aller plus loin
Ce tutoriel vous a été utile ? Contactez-moi pour un accompagnement personnalisé sur n8n.