Aller au contenu principal
Intégrations

Comment connecter Gmail a n8n avec OAuth2

Publié le 8 janvier 202510min

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.

1

Créer le credential dans n8n

n8n > Credentials > Create Credential
  1. 1Rechercher "Gmail OAuth2 API"
  2. 2Copier l'OAuth Redirect URL (nécessaire à l'étape 5)
  3. 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

Ce tutoriel vous a été utile ? Contactez-moi pour un accompagnement personnalisé sur n8n.