Mailgun

Catalogue des nœuds Actions

Sur cette page

API Mailgun : messages, listes, domaines, événements, webhooks

Utilisation et spécificités

Sélectionnez une opération, renseignez les paramètres de chemin et de requête, puis les champs guidés du corps. Le mode avancé expose le catalogue complet et custom_request permet un appel personnalisé. Les droits, domaines d’envoi et signatures webhook restent propres au fournisseur.

Type technique : mailgun. Runtime : nodulz.

Identifiants et prérequis

Créer et configurer l’identifiant : mailgun

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`credentialId`	`string`	`""`	-
`operation`	`string`	`"post_messages"`	-
`pathParams`	`string`	`"{}"`	-
`queryParams`	`string`	`"{}"`	-
`body`	`string`	`""`	-
`bodyFieldValues`	`string`	`"{}"`	-
`customMethod`	`enum`	`"post"`	`get`, `post`, `put`, `patch`, `delete`
`customPath`	`string`	`""`	-
`requestMode`	`enum`	`"curated"`	`curated`, `advanced`
`defaultDomain`	`string`	`""`	-

Opérations disponibles

ID	HTTP	Chemin / paramètres
`get_domains`	`get`	`/v3/domains`
`post_domains`	`post`	`/v3/domains` - `name` * (string), `spam_action` (string), `wildcard` (boolean) - corps requis
`get_domain`	`get`	`/v3/domains/{domain}` - pathParams: `domain`
`delete_domain`	`delete`	`/v3/domains/{domain}` - pathParams: `domain`
`post_messages`	`post`	`/v3/{domain}/messages` - pathParams: `domain` - `from` * (string), `to` * (string), `subject` (string), `text` (string), `html` (string), `template` (string), `cc` (string), `bcc` (string), `tags` (string) - corps requis
`get_events`	`get`	`/v3/{domain}/events` - pathParams: `domain`
`get_mailing_lists`	`get`	`/v3/lists/pages`
`post_mailing_lists`	`post`	`/v3/lists` - `address` * (string), `name` (string), `description` (string), `access_level` (string) [`readonly`, `members`, `everyone`] - corps requis
`get_mailing_list`	`get`	`/v3/lists/{address}` - pathParams: `address`
`put_mailing_list`	`put`	`/v3/lists/{address}` - pathParams: `address` - `name` (string), `description` (string), `access_level` (string) [`readonly`, `members`, `everyone`] - corps requis
`delete_mailing_list`	`delete`	`/v3/lists/{address}` - pathParams: `address`
`get_list_members`	`get`	`/v3/lists/{list}/members/pages` - pathParams: `list`
`post_list_members`	`post`	`/v3/lists/{list}/members` - pathParams: `list` - `address` * (string), `name` (string), `vars` (json), `subscribed` (boolean) - corps requis
`post_webhooks`	`post`	`/v3/domains/{domain}/webhooks` - pathParams: `domain` - `url` * (string), `id` (string) - corps requis
`get_webhooks`	`get`	`/v3/domains/{domain}/webhooks` - pathParams: `domain`
`put_webhooks`	`put`	`/v3/domains/{domain}/webhooks/{id}` - pathParams: `domain`, `id` - `url` * (string) - corps requis
`delete_webhooks`	`delete`	`/v3/domains/{domain}/webhooks/{id}` - pathParams: `domain`, `id`
`custom_request`	`post`	`{customPath}` - pathParams: `customPath`

L’astérisque signale un paramètre requis par cette opération. Les champs du corps et les droits nécessaires dépendent de l’opération choisie ; utilisez le formulaire guidé et la référence officielle du fournisseur.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "credentialId": "",
  "operation": "post_messages",
  "pathParams": "{}",
  "queryParams": "{}",
  "body": "",
  "bodyFieldValues": "{}",
  "customMethod": "post",
  "customPath": "",
  "defaultDomain": "",
  "requestMode": "curated"
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.