Mailgun

Also an agent tool

communication

Mailgun email delivery, domain/DKIM/IP management, routing, mailing lists, templates, suppressions, validation, analytics, and event webhooks via the Mailgun REST API

Provider API docs ↗

157 actions · 11 triggers

The Mailgun integration lets you connect Mailgun to your automations with 157 actions and 11 triggers — and every action is also a tool an AI agent can call. Examples: Send Message, Send MIME Message, Get Stored Message, Resend Stored Message, Get Sending Queues. No blank-canvas wiring — connect it and use it in your workflows.

Every action below is also a tool an AI agent can call — the same pack powers your workflows and your agents.

Triggers 11

Events in Mailgun that can start a workflow.

webhook

Message Accepted

Mailgun accepted the message for delivery

webhook

Message Delivered

Message delivered to the recipient MX

webhook

Message Temporary Failed

Transient delivery failure (will retry)

webhook

Message Permanent Failed

Permanent failure / hard bounce

webhook

Message Opened

Recipient opened the message (open tracking)

webhook

Message Clicked

Recipient clicked a tracked link

webhook

Message Unsubscribed

Recipient clicked the unsubscribe link

webhook

Message Complained

Recipient marked the message as spam

webhook

List Member Uploaded

Mailing-list bulk member uploaded (account webhook)

webhook

Inbound Message Received

Received mail forwarded by a route forward() HTTP action

polling

New Email Event

Follow paging.next URLs verbatim; ~3-day retention so poll frequently.

Actions 157

What Zervanor can do in Mailgun.

V3101

POST

Send Message

Send a message from structured form fields (POST /v3/{domain}/messages). Accepts multipart/form-data or x-www-form-urlencoded, not JSON.

POST

Send MIME Message

Send a pre-built raw MIME message (POST /v3/{domain}/messages.mime); form field message = MIME.

GET

Get Stored Message

Retrieve a stored/received message by storage key (GET /v3/domains/{domain}/messages/{storage_key}).

POST

Resend Stored Message

Resend a stored message (POST /v3/domains/{domain}/messages/{storage_key}).

GET

Get Sending Queues

Get default + scheduled message queue status for a domain (GET /v3/domains/{domain}/sending_queues).

DELETE

Purge Scheduled Mail

Purge all scheduled/undelivered mail from the queue (DELETE /v3/{domain}/envelopes); must hit matching storage host.

DELETE

Delete Domain

Delete a domain (DELETE /v3/domains/{name}).

PUT

Update DKIM Authority

Delegate DKIM authority to another domain (PUT /v3/domains/{name}/dkim_authority).

PUT

Update DKIM Selector

Update the DKIM selector (PUT /v3/domains/{name}/dkim_selector).

POST

Create Route

Create a route with filter expression + actions (POST /v3/routes).

GET

List Routes

List all account routes (GET /v3/routes).

GET

Get Route

Get a single route (GET /v3/routes/{id}).

PUT

Update Route

Update a route (selective fields) (PUT /v3/routes/{id}).

DELETE

Delete Route

Delete a route (DELETE /v3/routes/{id}).

GET

Match Route

Test whether an address matches any route (GET /v3/routes/match).

POST

Create Mailing List

Create a mailing list (POST /v3/lists).

GET

List Mailing Lists

List mailing lists (GET /v3/lists).

GET

Paginate Mailing Lists

Paginate mailing lists (GET /v3/lists/pages).

GET

Get Mailing List

Get a single mailing list (GET /v3/lists/{list_address}).

PUT

Update Mailing List

Update a list (PUT /v3/lists/{list_address}).

DELETE

Delete Mailing List

Delete a list (DELETE /v3/lists/{list_address}).

POST

Add List Member

Add a member to a list (POST /v3/lists/{list_address}/members).

GET

List List Members

List members of a list (GET /v3/lists/{list_address}/members).

GET

Paginate List Members

Paginate members of a list (GET /v3/lists/{list_address}/members/pages).

GET

Get List Member

Get a single list member (GET /v3/lists/{list_address}/members/{member_address}).

PUT

Update List Member

Update a list member (PUT /v3/lists/{list_address}/members/{member_address}).

DELETE

Delete List Member

Delete a list member (DELETE /v3/lists/{list_address}/members/{member_address}).

POST

Bulk Add Members (JSON)

Bulk add up to 1000 members as JSON (POST /v3/lists/{list_address}/members.json).

POST

Bulk Add Members (CSV)

Bulk add up to 1000 members from CSV (POST /v3/lists/{list_address}/members.csv).

GET

List Domain Templates

List domain templates (GET /v3/{domain}/templates).

POST

Create Domain Template

Create a domain template (POST /v3/{domain}/templates).

DELETE

Delete All Domain Templates

Delete all domain templates (DELETE /v3/{domain}/templates).

GET

Get Domain Template

Get a domain template (GET /v3/{domain}/templates/{template}).

PUT

Update Domain Template

Update domain template description (PUT /v3/{domain}/templates/{template}).

DELETE

Delete Domain Template

Delete a domain template (DELETE /v3/{domain}/templates/{template}).

PUT

Rename Domain Template

Rename a domain template (PUT /v3/{domain}/templates/{template}/rename/{new_name}).

PUT

Copy Domain Template

Copy a domain template (PUT /v3/{domain}/templates/{template}/copy).

GET

List Domain Template Versions

List versions of a domain template (GET /v3/{domain}/templates/{template}/versions).

POST

Add Domain Template Version

Add a version to a domain template (POST /v3/{domain}/templates/{template}/versions).

GET

Get Domain Template Version

Get a domain template version (GET /v3/{domain}/templates/{template}/versions/{version}).

PUT

Update Domain Template Version

Update a domain template version (PUT /v3/{domain}/templates/{template}/versions/{version}).

DELETE

Delete Domain Template Version

Delete a domain template version (DELETE /v3/{domain}/templates/{template}/versions/{version}).

PUT

Copy Domain Template Version

Copy a domain template version (PUT /v3/{domain}/templates/{template}/versions/{version}/copy/{new_version}).

GET

List Bounces

List bounces (GET /v3/{domain}/bounces).

GET

Get Bounce

Get one bounce (GET /v3/{domain}/bounces/{address}).

POST

Add Bounce

Add bounce(s) (POST /v3/{domain}/bounces).

POST

Import Bounces

Import bounces from CSV (POST /v3/{domain}/bounces/import).

DELETE

Delete Bounce

Delete one bounce (DELETE /v3/{domain}/bounces/{address}).

DELETE

Delete All Bounces

Delete all bounces (DELETE /v3/{domain}/bounces).

GET

List Complaints

List complaints (GET /v3/{domain}/complaints).

GET

Get Complaint

Get one complaint (GET /v3/{domain}/complaints/{address}).

POST

Add Complaint

Add complaint(s) (POST /v3/{domain}/complaints).

POST

Import Complaints

Import complaints from CSV (POST /v3/{domain}/complaints/import).

DELETE

Delete Complaint

Delete one complaint (DELETE /v3/{domain}/complaints/{address}).

DELETE

Delete All Complaints

Delete all complaints (DELETE /v3/{domain}/complaints).

GET

List Unsubscribes

List unsubscribes (GET /v3/{domain}/unsubscribes).

GET

Get Unsubscribe

Get one unsubscribe (GET /v3/{domain}/unsubscribes/{address}).

POST

Add Unsubscribe

Add unsubscribe(s) (POST /v3/{domain}/unsubscribes).

POST

Import Unsubscribes

Import unsubscribes from CSV (POST /v3/{domain}/unsubscribes/import).

DELETE

Delete Unsubscribe

Delete one unsubscribe to resume delivery (DELETE /v3/{domain}/unsubscribes/{address}).

DELETE

Delete All Unsubscribes

Delete all unsubscribes (DELETE /v3/{domain}/unsubscribes).

GET

List Allowlist Entries

List allowlist (whitelist) entries (GET /v3/{domain}/whitelists).

GET

Get Allowlist Entry

Get one allowlist entry (GET /v3/{domain}/whitelists/{value}).

POST

Add Allowlist Entry

Add an allowlist entry (POST /v3/{domain}/whitelists).

POST

Import Allowlist

Import allowlist from CSV (POST /v3/{domain}/whitelists/import).

DELETE

Delete Allowlist Entry

Delete one allowlist entry (DELETE /v3/{domain}/whitelists/{value}).

DELETE

Delete Entire Allowlist

Delete entire allowlist (DELETE /v3/{domain}/whitelists).

GET

Query Events

Query message events with ~3-day retention; paginate via paging.next/previous URLs (GET /v3/{domain}/events).

GET

List Tags

List tags for a domain (GET /v3/{domain}/tags). Deprecated by Mailgun.

GET

Get Tag

Get a tag (GET /v3/{domain}/tag).

PUT

Create or Update Tag

Create/update a tag (PUT /v3/{domain}/tag).

DELETE

Delete Tag

Delete a tag (DELETE /v3/{domain}/tag).

GET

Get Tag Stats

Get tag stats (GET /v3/{domain}/tag/stats).

GET

Get Tag Stat Aggregates

Tag stat aggregates by event type (GET /v3/{domain}/tag/stats/aggregates).

GET

Get Tag Limits

Get tag limits for a domain (GET /v3/domains/{domain}/limits/tag).

GET

List Domain Webhooks

List domain webhooks (GET /v3/domains/{domain}/webhooks).

POST

Create Domain Webhook

Create a domain webhook for a single event (POST /v3/domains/{domain}/webhooks).

GET

Get Domain Webhook

Get a domain webhook by event name (GET /v3/domains/{domain}/webhooks/{name}).

PUT

Update Domain Webhook

Replace a domain webhook URL (PUT /v3/domains/{domain}/webhooks/{name}).

DELETE

Delete Domain Webhook

Delete a domain webhook (DELETE /v3/domains/{domain}/webhooks/{name}).

GET

List IPs

List account IPs (GET /v3/ips).

GET

Get IP

Get a single IP details (GET /v3/ips/{ip}).

GET

List IP Domains

List domains an IP is assigned to (GET /v3/ips/{ip}/domains).

POST

Assign IP To Domains

Assign an IP to all account domains (POST /v3/ips/{ip}/domains).

DELETE

Remove IP From Domains

Remove an IP from all account domains (DELETE /v3/ips/{ip}/domains).

POST

Request New IP

Request a new dedicated IP (POST /v3/ips/request/new).

GET

List All IPs (Account + Subaccounts)

List IPs across account + subaccounts (GET /v3/ips/details/all).

POST

Set IP Band

Place an IP into a dedicated IP band (POST /v3/ips/{ip}/ip_band).

GET

List IP Pools

List dedicated IP pools (GET /v3/ip_pools).

POST

Create IP Pool

Create an IP pool (POST /v3/ip_pools).

GET

Get IP Pool

Get a pool (GET /v3/ip_pools/{pool_id}).

PATCH

Update IP Pool

Update pool properties / IPs (PATCH /v3/ip_pools/{pool_id}).

DELETE

Delete IP Pool

Delete a pool with optional replacement (DELETE /v3/ip_pools/{pool_id}).

GET

List IP Pool Domains

List domains linked to a pool (GET /v3/ip_pools/{pool_id}/domains).

PUT

Add IP To Pool

Add an IP to a pool (PUT /v3/ip_pools/{pool_id}/ips/{ip}).

DELETE

Remove IP From Pool

Remove an IP from a pool (DELETE /v3/ip_pools/{pool_id}/ips/{ip}).

POST

Add Multiple IPs To Pool

Add multiple IPs to a pool (POST /v3/ip_pools/{pool_id}/ips.json).

PUT

Delegate IP Pool

Delegate a pool to a subaccount (PUT /v3/ip_pools/{pool_id}/delegate).

DELETE

Revoke IP Pool Delegation

Revoke subaccount delegation (DELETE /v3/ip_pools/{pool_id}/delegate).

DELETE

Remove IP From Domain Pool

Remove an IP from a domain pool (DELETE /v3/domains/{name}/ips/{ip}).

DELETE

Unlink Pool From Domain

Remove an IP / unlink pool from a domain (DELETE /v3/domains/{name}/pool/{ip}).

V435

GET

List Domains

List domains, optionally filtered by state/authority (GET /v4/domains).

POST

Create Domain

Create a sending domain (POST /v4/domains).

GET

Get Domain

Get a single domain state and settings (GET /v4/domains/{name}).

PUT

Update Domain

Update domain config: SMTP creds, sender security, spam action, wildcard, web scheme (PUT /v4/domains/{name}).

PUT

Verify Domain

Re-verify the domain DNS records (PUT /v4/domains/{name}/verify).

GET

List Domain DKIM Keys

List all DKIM keys for a domain (GET /v4/domains/{authority}/keys).

PUT

Activate DKIM Key

Activate a key for DKIM signing (PUT /v4/domains/{authority}/keys/{selector}/activate).

PUT

Deactivate DKIM Key

Deactivate a key (PUT /v4/domains/{authority}/keys/{selector}/deactivate).

GET

List Account Templates

List account templates (GET /v4/templates).

POST

Create Account Template

Create an account template (POST /v4/templates).

DELETE

Delete All Account Templates

Delete all account templates (DELETE /v4/templates).

GET

Get Account Template

Get a template with active version (GET /v4/templates/{template}).

PUT

Update Account Template

Update template description (PUT /v4/templates/{template}).

DELETE

Delete Account Template

Delete a template and all versions (DELETE /v4/templates/{template}).

PUT

Rename Account Template

Rename a template (PUT /v4/templates/{template}/rename/{new_name}).

PUT

Copy Account Template

Copy a template (PUT /v4/templates/{template}/copy).

GET

List Account Template Versions

List versions of a template (GET /v4/templates/{template}/versions).

POST

Add Account Template Version

Add a version (POST /v4/templates/{template}/versions).

GET

Get Account Template Version

Get a version (GET /v4/templates/{template}/versions/{version}).

PUT

Update Account Template Version

Update a version content/active flag (PUT /v4/templates/{template}/versions/{version}).

DELETE

Delete Account Template Version

Delete a version (DELETE /v4/templates/{template}/versions/{version}).

PUT

Copy Account Template Version

Copy a version (PUT /v4/templates/{template}/versions/{version}/copy/{new_version}).

POST

Create Domain Webhooks (Multi-Event)

Create webhooks for multiple event types (POST /v4/domains/{domain}/webhooks).

PUT

Update Domain Webhooks (Multi-Event)

Update event-type associations (PUT /v4/domains/{domain}/webhooks).

DELETE

Delete Domain Webhooks (Multi-Event)

Delete webhooks from event types (DELETE /v4/domains/{domain}/webhooks).

GET

Validate Address

Validate a single email address (GET /v4/address/validate).

POST

Validate Address (POST)

Validate a single address via form body (POST /v4/address/validate).

POST

Start Bulk Validation

Start a bulk validation job by uploading a file (POST /v4/address/validate/bulk/{list_id}).

GET

Get Bulk Validation Job

Get bulk validation job status / download URLs (GET /v4/address/validate/bulk/{list_id}).

DELETE

Delete Bulk Validation Job

Cancel / delete a bulk validation job (DELETE /v4/address/validate/bulk/{list_id}).

GET

List Bulk Validation Jobs

List bulk validation jobs (GET /v4/address/validate/bulk).

POST

Start List Preview Validation

Start a list-health preview job (POST /v4/address/validate/preview/{list_id}).

GET

Get Preview Validation Job

Get preview job status (GET /v4/address/validate/preview/{list_id}).

DELETE

Delete Preview Validation Job

Delete a preview job (DELETE /v4/address/validate/preview/{list_id}).

GET

List Preview Validation Jobs

List preview jobs (GET /v4/address/validate/preview).

V111

GET

List Domain Keys

List domain keys, filter by signing domain/selector (GET /v1/dkim/keys).

POST

Create Domain Key

Create a new domain key or import an existing PEM (POST /v1/dkim/keys).

DELETE

Delete Domain Key

Delete a domain key permanently (DELETE /v1/dkim/keys).

POST

Query Metrics

Query filtered account metrics (POST /v1/analytics/metrics). JSON body.

POST

Query Usage Metrics

Query filtered account usage metrics (POST /v1/analytics/usage/metrics). JSON body.

GET

List Account Webhooks

List account webhooks (GET /v1/webhooks).

POST

Create Account Webhook

Create account webhook(s) (POST /v1/webhooks).

GET

Get Account Webhook

Get an account webhook (GET /v1/webhooks/{id}).

PUT

Update Account Webhook

Update an account webhook (PUT /v1/webhooks/{id}).

DELETE

Delete Account Webhook

Delete an account webhook (DELETE /v1/webhooks/{id}).

DELETE

Delete Account Webhooks

Delete account webhooks (all or by IDs) (DELETE /v1/webhooks).

V510

GET

List Subaccounts

List subaccounts (GET /v5/accounts/subaccounts).

POST

Create Subaccount

Create a subaccount (POST /v5/accounts/subaccounts).

GET

Get Subaccount

Get a subaccount (GET /v5/accounts/subaccounts/{id}).

DELETE

Delete Subaccount

Delete a subaccount (DELETE /v5/accounts/subaccounts/{id}).

POST

Enable Subaccount

Enable a subaccount (POST /v5/accounts/subaccounts/{id}/enable).

POST

Disable Subaccount

Disable a subaccount (POST /v5/accounts/subaccounts/{id}/disable).

GET

Get Subaccount Monthly Limit

Get custom monthly sending limit (GET /v5/accounts/subaccounts/{id}/limit/custom/monthly).

PUT

Set Subaccount Monthly Limit

Set custom monthly sending limit (PUT /v5/accounts/subaccounts/{id}/limit/custom/monthly).

DELETE

Remove Subaccount Monthly Limit

Remove custom monthly sending limit (DELETE /v5/accounts/subaccounts/{id}/limit/custom/monthly).

PUT

Update Subaccount Features

Update subaccount features (PUT /v5/accounts/subaccounts/{id}/features).

Automations using Mailgun

Build your own automation with Mailgun in the visual builder.

Frequently asked questions

What can I automate with Mailgun?

157 actions are available — for example: Send Message, Send MIME Message, Get Stored Message, Resend Stored Message, Get Sending Queues, and more.

Which Mailgun events can start a workflow?

11 triggers — for example: Message Accepted, Message Delivered, Message Temporary Failed, Message Permanent Failed.

Can Mailgun be used as an AI agent tool?

Yes. Every Mailgun action automatically becomes a tool an AI agent can call — the same pack powers both your workflows and your agents.

How is the Mailgun integration modelled?

Mailgun is modelled as a versioned connector pack, and the steps that need reasoning fall to first-party agents hosted in the same runtime as the workflows.