Mailgun Integration — ModuleX AI

Field	Description	Required	Format
Mailgun API Key	Private API key from Mailgun dashboard (Settings > API Security)	Yes	`key-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
Mailgun Region	API region: ‘US’ (default) or ‘EU’	No	`US`

send_email — Send an email via Mailgun

Parameters

string

required

Mailgun domain name to send from

string

required

Sender display name

string

required

Sender email address

array

required

Recipient email address(es) as a list of strings

string

required

Email subject line

string

Plain text message body

string

HTML message body

string

Reply-to email address

boolean

Enable Mailgun test mode (message accepted but not delivered) (Default: true)

boolean

Enable or disable DKIM signatures on the message (Default: true)

boolean

Enable or disable tracking on the message (Default: true)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Message"
    }
  },
  "required": [
    "success"
  ],
  "title": "SendEmailOutput",
  "type": "object"
}

verify_email — Verify an email address for deliverability using Mailgun's validation API

Parameters

string

required

Email address to verify

Response

{
  "$defs": {
    "EmailVerificationResult": {
      "additionalProperties": false,
      "properties": {
        "address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Address"
        },
        "did_you_mean": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Did You Mean"
        },
        "is_disposable_address": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Is Disposable Address"
        },
        "is_role_address": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Is Role Address"
        },
        "reason": {
          "items": {
            "type": "string"
          },
          "title": "Reason",
          "type": "array"
        },
        "result": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Result"
        },
        "risk": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Risk"
        }
      },
      "title": "EmailVerificationResult",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/EmailVerificationResult"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "VerifyEmailOutput",
  "type": "object"
}

create_mailinglist_member — Add a member to an existing Mailgun mailing list

Parameters

string

required

Mailing list address (e.g. list@yourdomain.com)

string

required

Email address of the member to add

string

Display name of the member

object

Extra arbitrary member data as a JSON object

string

Subscription status: ‘yes’ (default) or ‘no’ for unsubscribed (Default: yes)

string

If ‘yes’, update existing member; if ‘no’, error on duplicate. Values: yes, no (Default: no)

Response

{
  "$defs": {
    "MailinglistMember": {
      "additionalProperties": false,
      "properties": {
        "address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Address"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "subscribed": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Subscribed"
        },
        "vars": {
          "anyOf": [
            {
              "additionalProperties": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Vars"
        }
      },
      "title": "MailinglistMember",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "member": {
      "anyOf": [
        {
          "$ref": "#/$defs/MailinglistMember"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateMailinglistMemberOutput",
  "type": "object"
}

create_route — Create a new Mailgun route for email matching and forwarding

Parameters

integer

required

Route priority (lower numbers are evaluated first)

string

required

Human-readable description of the route

string

required

Mailgun route filter expression, e.g. match_recipient(’.*@example.com’)

array

required

List of route action strings, e.g. [‘forward(“dest@example.com”)’, ‘stop()‘]

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "route_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Route Id"
    },
    "route_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Route Message"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateRouteOutput",
  "type": "object"
}

delete_mailinglist_member — Delete a member from a Mailgun mailing list by email address

Parameters

string

required

Mailing list address (e.g. list@yourdomain.com)

string

required

Email address of the member to remove

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "member_address": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Member Address"
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Message"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteMailinglistMemberOutput",
  "type": "object"
}

list_domains — List all domains configured in the Mailgun account

Parameters

string

Filter by domain state: active, unverified, disabled (Default: active)

Response

{
  "$defs": {
    "DomainSummary": {
      "additionalProperties": false,
      "properties": {
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Type"
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Created At"
        },
        "smtp_login": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Smtp Login"
        },
        "web_prefix": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Web Prefix"
        }
      },
      "title": "DomainSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "domains": {
      "items": {
        "$ref": "#/$defs/DomainSummary"
      },
      "title": "Domains",
      "type": "array"
    },
    "total_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total Count"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListDomainsOutput",
  "type": "object"
}

list_mailinglist_members — List all members of a Mailgun mailing list

Parameters

string

required

Mailing list address (e.g. list@yourdomain.com)

string

Filter by subscription: ‘true’ for subscribed only, ‘false’ for unsubscribed only, or omit for all

Response

{
  "$defs": {
    "MailinglistMember": {
      "additionalProperties": false,
      "properties": {
        "address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Address"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "subscribed": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Subscribed"
        },
        "vars": {
          "anyOf": [
            {
              "additionalProperties": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Vars"
        }
      },
      "title": "MailinglistMember",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "members": {
      "items": {
        "$ref": "#/$defs/MailinglistMember"
      },
      "title": "Members",
      "type": "array"
    },
    "total_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total Count"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListMailinglistMembersOutput",
  "type": "object"
}

retrieve_mailinglist_member — Get details of a specific mailing list member by email address

Parameters

string

required

Mailing list address (e.g. list@yourdomain.com)

string

required

Email address of the member to retrieve

Response

{
  "$defs": {
    "MailinglistMember": {
      "additionalProperties": false,
      "properties": {
        "address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Address"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "subscribed": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Subscribed"
        },
        "vars": {
          "anyOf": [
            {
              "additionalProperties": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Vars"
        }
      },
      "title": "MailinglistMember",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "member": {
      "anyOf": [
        {
          "$ref": "#/$defs/MailinglistMember"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "RetrieveMailinglistMemberOutput",
  "type": "object"
}

suppress_email — Add an email address to a Mailgun suppression list (bounces, unsubscribes, or complaints)

Parameters

string

required

Mailgun domain name

string

required

Email address to suppress

string

required

Suppression list category: bounces, unsubscribes, or complaints

string

Bounce error code (only for ‘bounces’ category) (Default: 550)

string

Bounce error message (only for ‘bounces’ category)

string

Tag to unsubscribe from (only for ‘unsubscribes’ category). Use ’*’ for all. (Default: *)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Message"
    }
  },
  "required": [
    "success"
  ],
  "title": "SuppressEmailOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Mailgun Integration for AI Agents & Workflows

Overview

Authentication

Mailgun API Key

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

AgentMail

Gmail

Microsoft Outlook

Links

​Overview

​Authentication

​Mailgun API Key

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

AgentMail

Gmail

Microsoft Outlook

​Links

Overview

Authentication

Mailgun API Key

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links