Intégration SendGrid n8nAutomatiser SendGrid avec n8n.

Envoie un contact vers SendGrid et laisse l'adresse trancher : inconnue, elle crée le contact ; déjà stockée, elle met la fiche à jour.

• Email : l'adresse principale du contact (name@email.com), souvent {{ $json.email }} quand elle vient du nœud précédent.
• List IDs : dans Additional Fields, les listes que le contact rejoint tout de suite, ce qui évite un second appel.
• Custom Fields : la collection qui transporte les valeurs que SendGrid ne prévoit pas, un segment interne par exemple.

Retire des contacts du compte SendGrid. Deux entrées possibles : une série d'identifiants, ou l'interrupteur qui vide tout.

• Contact IDs : l'ID du contact, plusieurs séparés par une virgule quand le lot arrive dans un seul item.
• Delete All : activé, tous les contacts partent. À laisser fermé tant que vider l'audience entière n'est pas l'objectif.

Récupère un contact et un seul, par identifiant ou par adresse, puis transmet la fiche stockée au nœud suivant.

• By : le mode de recherche, id ou email. Il commande lequel des deux champs suivants le nœud lit.
• Contact ID : l'ID du contact, lu quand By vaut id.
• Email : l'adresse du contact (name@email.com). C'est la voie la plus courte quand le workflow connaît l'email mais pas l'identifiant, avec {{ $json.email }} en entrée.

Lit les contacts en nombre, avec ou sans filtre de recherche, et sort un item par contact vers la suite du workflow.

• Return All : coché, n8n enchaîne les pages de l'API SendGrid jusqu'au dernier contact. Décoché, il s'arrête à Limit.
• Limit : le nombre maximal de contacts renvoyés tant que Return All reste décoché, pratique pour un essai.
• Query : dans Filters, une expression SGQL, le langage de recherche de contacts de SendGrid.

Crée une liste vide dans SendGrid et renvoie son identifiant, que les nœuds suivants utilisent comme destination.

• Name : le nom de la liste, requis, et le seul champ demandé par l'opération.

Fait disparaître une liste du compte. Un second interrupteur décide du sort des contacts qui s'y trouvent.

• List ID : l'ID de la liste, requis, en général lu depuis list.getAll plutôt que recopié à la main.
• Delete Contacts : activé, les contacts de la liste sont supprimés aussi. Désactivé, seule la liste s'en va.

Renvoie une liste et son détail, avec la possibilité de ramener un échantillon des contacts qu'elle contient.

• List ID : l'ID de la liste à lire, requis.
• Contact Sample : activé, la réponse contient l'échantillon de contacts, de quoi vérifier d'un coup d'œil ce qui est arrivé dedans.

Ramène les listes du compte. C'est la façon qu'a un workflow de trouver un ID sans aller le copier dans l'interface SendGrid.

• Return All : coché, n8n parcourt les pages jusqu'à la dernière liste. Décoché, il s'arrête à Limit.
• Limit : le nombre maximal de listes renvoyées, utile pendant la construction du workflow.

Renomme une liste existante. Les deux champs sont requis, le nœud n'envoie donc jamais un nom vide à SendGrid.

• List ID : l'ID de la liste à renommer, requis.
• Name : le nouveau nom de la liste, requis lui aussi.

Envoie l'email lui-même, avec un contenu écrit dans le nœud ou via un modèle dynamique SendGrid rempli par les données du workflow.

• Dynamic Template : requis. Activé, l'email s'appuie sur un modèle et ses champs. Désactivé, il part avec le contenu saisi en dessous.
• Message Body : requis, le corps du message à envoyer.
• Recipient Email, Sender Email, Subject : les destinataires séparés par des virgules, l'adresse d'expédition, l'objet.
• MIME Type : text/plain ou text/html.
• Send At : le moment de la distribution, jamais au-delà de 72 heures.