Skip to main content
The Mailgun node adds Mailgun operations to your workflows. Add it on the canvas or ask the AI builder for it by name, then pick an operation and fill in its fields. Mailgun also includes 9 trigger operations (marked in the tables below) that can start a workflow when something happens in Mailgun.
You can wire the Mailgun node into an AI agent as a tool provider: the agent calls the operations you allow. See Agent tools.

​
Credentials

Connect Mailgun under Credentials in the node settings. See Connecting credentials for the general flow. Enter the values manually when creating the credential. Get your credentials here.

​
Operations

​
Analytics

OperationIDDescriptionTrigger
Get Metricsget_metricsRetrieve aggregated sending analytics (Metrics API).
List Eventslist_eventsQuery message events (accepted, delivered, opened, failed, …).
Query Logsquery_logsQuery the newer Logs/analytics API for message activity.

​
Domains

OperationIDDescriptionTrigger
Create Domaincreate_domainAdd a new sending domain.
Delete Domaindelete_domainRemove a sending domain.
Get Domainget_domainGet details and DNS records for a domain.
List Domainslist_domainsList sending domains.
Verify Domainverify_domainTrigger / check DNS verification for a domain.

​
Mailing lists

OperationIDDescriptionTrigger
Add Memberadd_memberAdd a single member to a mailing list.
Bulk Add Membersbulk_add_membersAdd up to 1000 members to a mailing list in one call.
Create Mailing Listcreate_mailing_listCreate a new mailing list.
Delete Memberdelete_memberRemove a member from a mailing list.
List Mailing Listslist_mailing_listsList all mailing lists.
List Memberslist_membersList members of a mailing list.

​
Messages

OperationIDDescriptionTrigger
Get Stored Messageget_stored_messageRetrieve a stored / inbound message by its storage key.
Send Messagesend_messageSend an email message through a sending domain.
Send MIME Messagesend_mimeSend a pre-built raw MIME (RFC 2822) message.

​
Routes

OperationIDDescriptionTrigger
Create Routecreate_routeCreate an inbound route (match expression -> action).
Delete Routedelete_routeDelete an inbound route.
List Routeslist_routesList inbound-email routing rules.

​
Suppressions

OperationIDDescriptionTrigger
Add Unsubscribeadd_unsubscribeAdd an unsubscribe record to the suppression list.
List Bounceslist_bouncesList suppressed bounce addresses.

​
Templates

OperationIDDescriptionTrigger
Create Templatecreate_templateStore a new reusable email template.
Create Template Versioncreate_template_versionAdd a new version to an existing template.
Get Templateget_templateRetrieve a template and its versions.
List Templateslist_templatesList stored account-level templates.

​
Validation

OperationIDDescriptionTrigger
Validate Email Addressvalidate_addressValidate a single email address (deliverability, risk, role flags).

​
Webhooks

OperationIDDescriptionTrigger
List Webhookslist_webhooksList configured event webhooks for a domain.

​
Other

OperationIDDescriptionTrigger
On Email Acceptedon_acceptedFire when Mailgun accepts a message for delivery.Yes
On Email Clickedon_clickedFire when a recipient clicks a tracked link (click tracking required).Yes
On Email Deliveredon_deliveredFire when a message is delivered to the recipient’s server.Yes
On Email Openedon_openedFire when a recipient opens a message (open tracking required).Yes
On Hard Bounceon_hard_bounceFire on a permanent failure / hard bounce.Yes
On Inbound Emailon_inbound_emailFire when an email is RECEIVED at the domain (via a Mailgun route forward).Yes
On Soft Bounceon_soft_bounceFire on a temporary failure / soft bounce (deferred).Yes
On Spam Complainton_spam_complaintFire when a recipient marks a message as spam.Yes
On Unsubscribeon_unsubscribedFire when a recipient unsubscribes.Yes