Mattering Automations Mailgun integration

Connect Mailgun to Mattering Automations: send email, query events and stats, manage mailing lists and members, validate addresses, and read suppression lists as workflow steps.

Get the credential Connect Verify Node reference Troubleshooting

The Mattering Automations Mailgun integration adds Mailgun to your automation canvas: send email through your sending domains, query the event log and domain stats, manage mailing lists and their members, validate email addresses, and read and edit the bounce, unsubscribe, and complaint suppression lists.

Setup takes a few minutes: copy your private API key from Mailgun, attach it as a credential in Mattering, and choose the region your account is hosted in. This guide walks through each step and ends with the full node reference.

Before you start

A Mailgun account with a verified sending domain.
Your Mailgun private API key, from the account settings.
A Mattering workspace with access to the Automations app.
Knowledge of which Mailgun region your account uses, US or EU, since the two stacks hold separate data.

Find your Mailgun private API key

Mattering authenticates to Mailgun over HTTP Basic auth: the username is the fixed word api and the password is your account's private API key. You only need to supply the key.

In Mailgun, open your account menu and go to API Keys (in the API Security or API Keys section of account settings).

Copy your Private API key.

The private API key can send email and manage suppression lists on your account. Treat it like a password and do not paste it into workflow steps or logs.

Connect Mailgun to Mattering

In Mattering Automations, open Connectors and click Add Connector.

Choose Mailgun from the list.

Click Create new credential, paste your private API key, and save. If the credential form shows a username field, enter the literal word api.

The credential is stored encrypted in Google Secret Manager and never appears in workflow logs.

Click Connect. All 17 Mailgun nodes appear in your canvas palette.

Each node has a region setting that defaults to us (api.mailgun.net). Set it to eu (api.eu.mailgun.net) on every node if your Mailgun account is hosted in the EU.

Verify it works

After connecting, open any automation canvas and check the palette: a Mailgun section should list the query and action nodes. Drop Mailgun: List Mailing Lists onto the canvas, leave the config empty, set the region to match your account, and run a test step; a successful response returns your account's mailing lists, which confirms the API key works.

To confirm sending, add a Mailgun: Send Email node, set the domain to one of your verified sending domains, fill from, to, subject, and text, and run the step to yourself. A successful response returns a Mailgun message id.

Node reference

17 nodes, generated from the connector itself so this reference always matches what ships.

Read and query nodes 9

Mailgun: Get Domain Stats

mailgun_get_domain_stats

Aggregate stat totals for a domain over a time window.

Mailgun: Get Events

mailgun_get_events

Query the event log for a domain (deliveries, opens, clicks, failures, ...).

Mailgun: Get Mailing List

mailgun_get_mailing_list

Get a single mailing list by address.

Mailgun: List Bounces

mailgun_list_bounces

List the bounced addresses on a domain's suppression list.

Mailgun: List Complaints

mailgun_list_complaints

List the spam-complaint addresses on a domain's suppression list.

Mailgun: List List Members

mailgun_list_members

List the members of a mailing list (paginated).

Mailgun: List Mailing Lists

mailgun_list_mailing_lists

List the mailing lists on the account (paginated).

Mailgun: List Unsubscribes

mailgun_list_unsubscribes

List the unsubscribed addresses on a domain's suppression list.

Mailgun: Validate Email Address

mailgun_validate_address

Validate a single email address (v4 endpoint; billed as a Validate credit).

Action nodes 8

Mailgun: Add List Member

mailgun_add_member

Add (or upsert) a member to a mailing list.

Mailgun: Add Unsubscribe

mailgun_add_unsubscribe

Add an address to a domain's unsubscribe suppression list.

Mailgun: Create Mailing List

mailgun_create_mailing_list

Create a new mailing list.

Mailgun: Delete Bounce

mailgun_delete_bounce

Remove an address from a domain's bounce suppression list.

Mailgun: Delete Mailing List

mailgun_delete_mailing_list

Delete a mailing list (removes all its members).

Mailgun: Remove List Member

mailgun_delete_member

Remove a member from a mailing list.

Mailgun: Send Email

mailgun_send_message

Send an email via a domain (form-encoded; use the `form` object for o:tag, h:Reply-To, template, etc.).

Mailgun: Update Mailing List

mailgun_update_mailing_list

Update a mailing list's settings.

Using the integration

On the automation canvas

Mailgun nodes chain with every other node: a new signup can be validated, added to a mailing list, and sent a welcome email, while a failed delivery event can open an assigned task in Mattering Productivity.

From AI assistants over MCP

Every node speaks MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and Matter can send email, query events, and manage lists through the same nodes your workflows use.

Region-aware requests

Mailgun runs separate US and EU stacks that do not share data. The region setting on each node picks the host, so multi-region setups can keep US and EU workflows side by side on one canvas.

Troubleshooting

A node returns a 401 Unauthorized

The API key is wrong or empty. Confirm you stored the private API key (not a sending or public key), and that the credential username, if the form has one, is the literal word api. Update the credential on the connector and retry.

A node returns 404 or an empty result for a domain that exists

The region likely does not match. A US key against the EU host, or the reverse, will not find your domain or lists. Set the node's region to us or eu to match where your Mailgun account is hosted.

Send Email fails or the message never arrives

Check that the domain field is a verified Mailgun sending domain, that from uses that domain, and that the recipient is not on the domain's bounce, unsubscribe, or complaint suppression list. The List Bounces, List Unsubscribes, and List Complaints nodes let you check.

Address validation returns an error or unexpected charge

Mailgun bills address validation as its own credit separate from sending. Confirm your plan includes validation, and check your validation allowance in Mailgun before running the Validate Email Address node at volume.

The Mailgun MCP

What connecting Mailgun unlocks for AI agents and automations, with common uses and FAQs.

More guides

All Automations documentation

Every integration guide, plus how connectors, credentials, and workflows fit together.

Mailgun is a trademark of its respective owner. Mattering uses platform names to identify the services these integrations connect to; no endorsement or affiliation is implied.