mailgun

name

mailgun

description

Mailgun is a powerful email delivery service designed for developers and businesses to send, receive, and track transactional and marketing emails with high reliability and scalability. Read and write Mailgun data through One: domains, templates, ippools, subaccounts, templateversions, ips and more, 254 actions with real parameter documentation. Use whenever the user asks to look something up in Mailgun, create or update a record there, or build code against the Mailgun API.

Mailgun through One

Mailgun is a powerful email delivery service designed for developers and businesses to send, receive, and track transactional and marketing emails with high reliability and scalability.

One exposes Mailgun through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform mailgun if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Mailgun is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Mailgun account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Domains

Action	Method	Path	Action id
Get a Domain's Sending Queues Status	GET	/v3/domains/{{name}}/sending_queues	conn_mod_def::GJ42ul-SL7A::f0ogbonKTRWF1Gix20kX0A
Get a Domain's Tag Limits	GET	/v3/domains/{{domain}}/limits/tag	conn_mod_def::GJ42wCiM8Vk::wGSQjlswTnO4a8tkGEeWqQ
Get a Domain’s Tracking Settings	GET	/v3/domains/{{name}}/tracking	conn_mod_def::GJ42rgp44zo::1zvVmOe_SAWJH0xv-4ujfg
Get Domain Details	GET	/v4/domains/{{name}}	conn_mod_def::GJ42r7uCpFc::v8GXSgyFS06okfRN0QAXgQ
List a Domain’s Supported Tag Devices	GET	/v3/domains/{{domain}}/tag/devices	conn_mod_def::GJ42u4mOkhE::bD5xyCPPTPe0rYoed0uQ5A
List Assignable Domains (Not Enrolled in Dynamic IP Pools)	GET	/v3/domains/dynamic_pools/assignable	conn_mod_def::GJ42sUJ_Css::OBD9fStGQFyWoPJnPQbgtA
List Domains	GET	/v4/domains	conn_mod_def::GJ42sBCW2Bo::3NT45k2wSh2Z05mTXQy3fg
List Supported Country Codes for a Domain	GET	/v3/domains/{{domain}}/tag/countries	conn_mod_def::GJ42u4u9Bcs::EYdr5xx0Qwu-csGPATQ7GQ
Activate a Domain’s DKIM Key	PUT	/v4/domains/{{authorityName}}/keys/{{selector}}/activate	conn_mod_def::GJ42qtX04vg::SkQ8Y7HUTlaKFZmg0C0BzA
Create a Domain	POST	/v4/domains	conn_mod_def::GJ42r7Zci1w::o4BSH3KzRcu45WryiLRWHg
Delete a Domain	DELETE	/v3/domains/{{name}}	conn_mod_def::GJ42r7h79L8::eu3Gx43eRNOATBNr1vePvA
Delete All SMTP Credentials for a Domain

10 more Domains actions are available through search.

Templates

Action	Method	Path	Action id
Get a Domain’s Template	GET	/v3/{{domainName}}/templates/{{templateName}}	conn_mod_def::GJ42rThzaIk::Zp1wrIR_SDqRk-KhVYK9CA
Get an Account-Level Template	GET	/v4/templates/{{templateName}}	conn_mod_def::GJ42ouZP5mo::z9MiU4rEQu6Y6Hi1t0ymyQ
List a Domain’s Templates	GET	/v3/{{domainName}}/templates	conn_mod_def::GJ42rW2ghr8::ued6a0w1SCiBfF_ZBdCkyg
List Account-Level Templates	GET	/v4/templates	conn_mod_def::GJ42ojIKf-o::TOAfnEcGSkKK0Q1Vnz7Ljg
Copy a Domain Template to Other Accounts	PUT	/v3/{{domainName}}/templates/{{templateName}}/copy	conn_mod_def::GJ42rDNdq34::FzajvMTuQByoGfZ0_Iax-w
Copy a Template	PUT	/v4/templates/{{templateName}}/copy	conn_mod_def::GJ42oXNx0As::tnSYASWjRaG4q4oA2fyc9A
Create a Domain Template	POST	/v3/{{domainName}}/templates	conn_mod_def::GJ42rCs2rSQ::iKdOtYOVSkSQr2GJStTsog
Create an Account-Level Template	POST	/v4/templates	conn_mod_def::GJ42oXQwH_4::7g6hPGRhSZq5o-w3a_ROxQ
Delete a Domain’s Template	DELETE	/v3/{{domainName}}/templates/{{templateName}}	conn_mod_def::GJ42rKATOZY::zFvp2QqWQgeFhvkAhOH6YQ
Delete All Account-Level Templates	DELETE	/v4/templates	conn_mod_def::GJ42oinvWzY::p9SSzH1gTU-rFKFh9yYqfw
Delete All Templates for a Domain	DELETE	/v3/{{domainName}}/templates	conn_mod_def::GJ42rKXjNi0::hKIEWXGZR6a9lDi2VmncoA
Delete an Account-Level Template

4 more Templates actions are available through search.

IpPools

Action	Method	Path	Action id
Get a Dedicated IP Pool’s (DIPP) Details	GET	/v3/ip_pools/{{poolId}}	conn_mod_def::GJ42tUJY-tQ::5aGco6FbTzmCKfw3DqVsnA
List Dedicated IP Pools	GET	/v3/ip_pools	conn_mod_def::GJ42tW2Do2c::h1gZt945RYuOo1TAM3PtHw
List Domains Linked to a Dedicated IP Pool (DIPP)	GET	/v3/ip_pools/{{poolId}}/domains	conn_mod_def::GJ42tVCSIoM::Wm2A3uh9QPGIdRQUYr1KgQ
Add a New Dedicated IP Pool (DIPP) to the Account	POST	/v3/ip_pools	conn_mod_def::GJ42tIsqQF4::jmUJMG_KR5SdJ5c_a7bNZA
Add an IP to a Dedicated IP Pool (DIPP)	PUT	/v3/ip_pools/{{poolId}}/ips/{{ip}}	conn_mod_def::GJ42tNNoRVc::LvYgr9PgQNaABzwdGlDz8Q
Add Multiple IPs to a Dedicated IP Pool (DIPP)	POST	/v3/ip_pools/{{poolId}}/ips.json	conn_mod_def::GJ42tJd9rBw::OU8PenXcRB2nsBp5Lssb7A
Delegate a Dedicated IP Pool (DIPP) to a Subaccount	PUT	/v3/ip_pools/{{poolId}}/delegate	conn_mod_def::GJ42tJT0z18::fFkQeSL_TzqArrvyVsAv3A
Delegate a DIPP to a Subaccount	PUT	/v5/accounts/subaccounts/{{subaccountId}}/ip_pool	conn_mod_def::GJ42u511bi0::chU8S7H_RlKgf6_7aHEYxQ
Delete a Dedicated IP Pool (DIPP)	DELETE	/v3/ip_pools/{{poolId}}	conn_mod_def::GJ42tU2Ujus::Y4jeCnkESAuE5QAuFqvtBg
Edit a Dedicated IP Pool (DIPP)	PATCH	/v3/ip_pools/{{poolId}}	conn_mod_def::GJ42tUpq35s::z7Jf3971QLqd0AiZ5x_PpA
Remove an IP from a Dedicated IP Pool (DIPP)	DELETE	/v3/ip_pools/{{poolId}}/ips/{{ip}}	conn_mod_def::GJ42tdxIqsQ::j-NWp2krTc2JUxNhi2HgwQ

Subaccounts

Action	Method	Path	Action id
Get a Subaccount	GET	/v5/accounts/subaccounts/{{subaccountId}}	conn_mod_def::GJ42vuJuPUA::PPeBhQZLSb6vce9oyMKt6Q
Get a Subaccount’s Custom Monthly Sending Limit	GET	/v5/accounts/subaccounts/{{subaccountId}}/limit/custom/monthly	conn_mod_def::GJ42v7INHWQ::9S1Y3pHERu-jEBtfPhmFNA
List All Subaccounts	GET	/v5/accounts/subaccounts	conn_mod_def::GJ42v6EomK0::QyipLrmkTLOiYbqjnMJgDw
Create a Subaccount	POST	/v5/accounts/subaccounts	conn_mod_def::GJ42vjL9gRM::iKbW9fVxQMaKXfUtQHS-Sw
Delete a Subaccount	DELETE	/v5/accounts/subaccounts	conn_mod_def::GJ42vvDsUh0::EBUTrqr2TqOSyqG8Y-Ab2Q
Delete a Subaccount’s Custom Monthly Sending Limit	DELETE	/v5/accounts/subaccounts/{{subaccountId}}/limit/custom/monthly	conn_mod_def::GJ42vuX7Ls4::npASpuMaRHmdhHI6IGoagQ
Disable a Subaccount	POST	/v5/accounts/subaccounts/{{subaccountId}}/disable	conn_mod_def::GJ42vvFts1M::6bxLd7o4SJ2XWxPwZP5Q9g
Enable a Subaccount	POST	/v5/accounts/subaccounts/{{subaccountId}}/enable	conn_mod_def::GJ42vyBo9Ks::PTJAA1rTTtmmEwj5BJ-f9g
Set a Subaccount’s Custom Monthly Sending Limit	PUT	/v5/accounts/subaccounts/{{subaccountId}}/limit/custom/monthly	conn_mod_def::GJ42v5lD-E8::68LLe1muTpSdjmtyGvR9Pw

TemplateVersions

Action	Method	Path	Action id
Get a Template Version (Domain → Template → Version)	GET	/v3/{{domainName}}/templates/{{templateName}}/versions/{{versionName}}	conn_mod_def::GJ42rLBZY_0::GH3L-QKrTbG5hzlR6hdTuw
Get an Account-Level Template Version	GET	/v4/templates/{{templateName}}/versions/{{versionName}}	conn_mod_def::GJ42oqO0sGc::CPSLERp1SyOWIwuCh1TEVQ
List an Account-Level Template’s Versions	GET	/v4/templates/{{templateName}}/versions	conn_mod_def::GJ42otmeaiY::x1c65oleREetqxh_FpB1kA
Copy a Template Version to a New Version (Domain Template)	PUT	/v3/{{domainName}}/templates/{{templateName}}/versions/{{versionName}}/copy/{{newVersionName}}	conn_mod_def::GJ42rAn-BXI::n2vWbgX3QuO7uhT4Nu3jYw
Copy an Account-Level Template Version	PUT	/v4/templates/{{templateName}}/versions/{{versionName}}/copy/{{newVersionName}}	conn_mod_def::GJ42oYE9UCw::pVOYShXHS7mgIbIjenCOqw
Create an Account-level Template Version	POST	/v4/templates/{{templateName}}/versions	conn_mod_def::GJ42ogM8i4I::TcSc48XwSQGRRjiXWh-NOw
Delete a Template Version for a Domain	DELETE	/v3/{{domainName}}/templates/{{templateName}}/versions/{{versionName}}	conn_mod_def::GJ42rKxria0::G13LrBTsTYKrdHL1DDWEug
Delete an Account-level Template Version	DELETE	/v4/templates/{{templateName}}/versions/{{versionName}}	conn_mod_def::GJ42ogTbQRA::LjOVgVpVSY28lmhh3IjEAQ
Update an Account Template Version	PUT	/v4/templates/{{templateName}}/versions/{{versionName}}	conn_mod_def::GJ42o2QfmSQ::4ESDhJCOSHSgml-K3bC1DQ

Ips

Action	Method	Path	Action id
Get Account IP Details	GET	/v3/ips/{{ip}}	conn_mod_def::GJ42tsbPE0k::US6RhjbpQK6pusPpoBEA2A
Get IP Request Allowance (Backwards Compatible)	GET	/v3/ips/request/new	conn_mod_def::GJ42t4qVNA4::OZnS0MoIT56m5pcKDZNBZQ
List Account IPs	GET	/v3/ips	conn_mod_def::GJ42ttIrkow::8sHdXoSoS2-RgzFWdmv_Bw
List Account IPs (Detailed View)	GET	/v3/ips/details/all	conn_mod_def::GJ42twLOqYs::mIuTqg6uQ3-MwMy5Or5dDg
Assign an IP to All Account Domains	POST	/v3/ips/{{ip}}/domains	conn_mod_def::GJ42tl3mWC8::bEdOF4aRQMawRZO2IgNJZQ
Place an IP Address into a Dedicated IP Band	POST	/v3/ips/{{addr}}/ip_band	conn_mod_def::GJ42ttG3fzY::sTXNI43KT82yGwBeAGyJRg
Remove an IP from All Account Domains	DELETE	/v3/ips/{{ip}}/domains	conn_mod_def::GJ42tuIId6I::sXqm4uUcQmCkp3w5GTUGMw
Request a New Dedicated IP for the Account	POST	/v3/ips/request/new	conn_mod_def::GJ42tdUsN8w::n_XhOct6QoWMPfNvTliODg

MailingListMembers

Action	Method	Path	Action id
Get a Mailing List Member	GET	/v3/lists/{{listAddress}}/members/{{memberAddress}}	conn_mod_def::GJ42ub1bTUs::r10iYFxiRcqEAnjYy5XEOA
List a Mailing List’s Members (Paginated)	GET	/v3/lists/{{listAddress}}/members/pages	conn_mod_def::GJ42ucp0e_E::oLpZMn7aRI2uu-zCpDWeAA
List Members in a Mailing List	GET	/v3/lists/{{listAddress}}/members	conn_mod_def::GJ42ufDQ3NA::qbrAF3-QS5eFn8HLDmiZfw
Bulk Upload Members to a Mailing List (CSV)	POST	/v3/lists/{{listAddress}}/members.csv	conn_mod_def::GJ42uJ5R_zA::KkaiXsuTQLKrfWDKB19gjQ
Bulk Upload Members to a Mailing List (JSON)	POST	/v3/lists/{{listAddress}}/members.json	conn_mod_def::GJ42uKhKfws::UzJWmVk-Qh619F97xYeBHw
Create a Mailing List Member	POST	/v3/lists/{{listAddress}}/members	conn_mod_def::GJ42uUHBKY0::vnQHK7qqTv-KPvvtx3Jh2w
Delete a Mailing List Member	DELETE	/v3/lists/{{listAddress}}/members/{{memberAddress}}	conn_mod_def::GJ42uTbVHCE::F6c62nUqTvudQMl7U-DqeQ
Update a Mailing List Member (List Address + Member Address)	PUT	/v3/lists/{{listAddress}}/members/{{memberAddress}}	conn_mod_def::GJ42upwf_78::aRkiYVQpSbWgm65ft0sZjg

Accounts

Action	Method	Path	Action id
Get Account Custom Monthly Sending Limit	GET	/v5/accounts/limit/custom/monthly	conn_mod_def::GJ42qg9hlHA::OHFR4Y8WSrGfyn48LgcMig
Get an Account's Webhook HTTP Signing Key	GET	/v5/accounts/http_signing_key	conn_mod_def::GJ42oMIlIo4::KtHH-GG5Qei9Cp0byEMD0g
Create or Regenerate an Account Webhook Signing Key	POST	/v5/accounts/http_signing_key	conn_mod_def::GJ42oOqrTis::-KOtg5HGS3WbWXka4Ma3bA
Re-enable an Account Disabled for Custom Sending Limit	PUT	/v5/accounts/limit/custom/enable	conn_mod_def::GJ42qhBAWos::SU6SOTb-RLGuoZRFvNm3bw
Resend an Account Activation Email to the Account Owner	POST	/v5/accounts/resend_activation_email	conn_mod_def::GJ42oX7vdw0::Xu309-0CS5aH9bax83yCqA
Set a Custom Monthly Sending Limit for an Account	PUT	/v5/accounts/limit/custom/monthly	conn_mod_def::GJ42qsEFA8k::RKFZSANVSPi3fjLZOhvEtA
Update Account Settings	PUT	/v5/accounts	conn_mod_def::GJ42oYtB54Y::u7rjACWERI-vHKPouvmYrw

Unsubscribes

Action	Method	Path	Action id
List a Domain’s Unsubscribes	GET	/v3/{{domainName}}/unsubscribes	conn_mod_def::GJ42wfmI2_U::YSO1tt17RXGolSknPCeqbw
Lookup an Unsubscribe Record for a Domain	GET	/v3/{{domainName}}/unsubscribes/{{address}}	conn_mod_def::GJ42weRoQbA::la_AILosR7ihcCuoVOZsMQ
Add Unsubscribes to a Domain	POST	/v3/{{domainName}}/unsubscribes	conn_mod_def::GJ42wgiUqqU::TdfZT0MpSFmitFHeMfRBGQ
Clear All Unsubscribes for a Domain	DELETE	/v3/{{domainName}}/unsubscribes	conn_mod_def::GJ42wf3AooQ::lU1a1iqITImSmyR6hI95kA
Import a Domain’s Unsubscribe List (CSV)	POST	/v3/{{domainName}}/unsubscribes/import	conn_mod_def::GJ42wfS69RA::CY2ynOwuT7y6pODKbQST1Q
Remove an Unsubscribe Address From a Domain	DELETE	/v3/{{domainName}}/unsubscribes/{{address}}	conn_mod_def::GJ42woDBFS0::4NQMCB3LRKWbEHqlxoN1ew

Webhooks

Action	Method	Path	Action id
Get an Account-Level Webhook by ID	GET	/v1/webhooks/{{webhookId}}	conn_mod_def::GJ42o1zn73w::eRfW9ZK7SSGYcstrqsEc1g
List Account-Level Webhooks	GET	/v1/webhooks	conn_mod_def::GJ42pCvu4Ic::vTJ5biqZTuCVrIBkuYKcYA
Create an Account-Level Webhook	POST	/v1/webhooks	conn_mod_def::GJ42o1yLL_U::cKoD2gy6SQ6LvjPlrQi_XA
Delete Account-Level Webhooks	DELETE	/v1/webhooks	conn_mod_def::GJ42o1oCRTI::ok8JIMW5QlSviqcf2e_oEw
Delete an Account-level Webhook by ID	DELETE	/v1/webhooks/{{webhookId}}	conn_mod_def::GJ42o4FLIMI::61uvWF0qTGG8PcTdulBXiw
Update an Account-level Webhook	PUT	/v1/webhooks/{{webhookId}}	conn_mod_def::GJ42pAUtyJ8::9xNxu09-QkmC8icBpm4mxQ

Whitelists

Action	Method	Path	Action id
List a Domain’s Allowlist (Whitelist) Records	GET	/v3/{{domainName}}/whitelists	conn_mod_def::GJ42pdYWX1Q::d2M31W5NSOOxBetDTCcqHA

5 more Whitelists actions are available through search.

This lists 90 of 254 actions. For anything not here, call search_one_platform_actions with platform mailgun. The full catalog is at https://www.withone.ai/knowledge/mailgun.

When a call fails

The error comes from Mailgun, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/mailgun

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.