[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76G83SZG523AFX2C44F7YJP":3,"skill-same:01M76G83SZG523AFX2C44F7YJP":66},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":15,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":35,"commitSha":36,"skillDirectory":37,"forksCount":13,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":40,"install":41,"resources":54},"01M76G83SZG523AFX2C44F7YJP","mailgun",null,"Mailgun API integration with managed OAuth. Transactional email service for sending, receiving, and tracking emails.\nUse this skill when users want to send emails, manage domains, routes, templates, mailing lists, or suppressions in Mailgun.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).","meghal86\u002Fstacksignal","meghal86","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F37388715?v=4","01M6CS2EW8SK89GH52R2ZEN8QQ","01M728J5CGY456EETEFG6HJBTM",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fmailgun\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fmailgun\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: mailgun\ndescription: |\n  Mailgun API integration with managed OAuth. Transactional email service for sending, receiving, and tracking emails.\n  Use this skill when users want to send emails, manage domains, routes, templates, mailing lists, or suppressions in Mailgun.\n  For other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\ncompatibility: Requires network access and valid Maton API key\nmetadata:\n  author: maton\n  version: \"1.0\"\n  clawdbot:\n    emoji: 🧠\n    homepage: \"https:\u002F\u002Fmaton.ai\"\n    requires:\n      env:\n        - MATON_API_KEY\n---\n\n# Mailgun\n\nAccess the Mailgun API with managed OAuth authentication. Send transactional emails, manage domains, routes, templates, mailing lists, suppressions, and webhooks.\n\n## Quick Start\n\n```bash\n# List domains\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n## Base URL\n\n```\nhttps:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002F{resource}\n```\n\nReplace `{resource}` with the actual Mailgun API endpoint path. The gateway proxies requests to `api.mailgun.net\u002Fv3` (US region) and automatically injects your OAuth token.\n\n**Regional Note:** Mailgun has US and EU regions. The gateway defaults to US region (api.mailgun.net).\n\n## Authentication\n\nAll requests require the Maton API key in the Authorization header:\n\n```\nAuthorization: Bearer $MATON_API_KEY\n```\n\n**Environment Variable:** Set your API key as `MATON_API_KEY`:\n\n```bash\nexport MATON_API_KEY=\"YOUR_API_KEY\"\n```\n\n### Getting Your API Key\n\n1. Sign in or create an account at [maton.ai](https:\u002F\u002Fmaton.ai)\n2. Go to [maton.ai\u002Fsettings](https:\u002F\u002Fmaton.ai\u002Fsettings)\n3. Copy your API key\n\n## Connection Management\n\nManage your Mailgun OAuth connections at `https:\u002F\u002Fctrl.maton.ai`.\n\n### List Connections\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections?app=mailgun&status=ACTIVE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Create Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'app': 'mailgun'}).encode()\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application\u002Fjson')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Get Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections\u002F{connection_id}')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n**Response:**\n```json\n{\n  \"connection\": {\n    \"connection_id\": \"78b5a036-c621-40c2-b74b-276195735af2\",\n    \"status\": \"ACTIVE\",\n    \"creation_time\": \"2026-02-12T02:24:16.551210Z\",\n    \"last_updated_time\": \"2026-02-12T02:25:03.542838Z\",\n    \"url\": \"https:\u002F\u002Fconnect.maton.ai\u002F?session_token=...\",\n    \"app\": \"mailgun\",\n    \"metadata\": {}\n  }\n}\n```\n\nOpen the returned `url` in a browser to complete OAuth authorization.\n\n### Delete Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections\u002F{connection_id}', method='DELETE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Specifying Connection\n\nIf you have multiple Mailgun connections, specify which one to use with the `Maton-Connection` header:\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Maton-Connection', '78b5a036-c621-40c2-b74b-276195735af2')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\nIf omitted, the gateway uses the default (oldest) active connection.\n\n## API Reference\n\n**Important:** Mailgun API uses `application\u002Fx-www-form-urlencoded` for POST\u002FPUT requests, not JSON.\n\n### Domains\n\n#### List Domains\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\n```\n\nReturns all domains for the account.\n\n#### Get Domain\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\n```\n\n#### Create Domain\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Fdomains\nContent-Type: application\u002Fx-www-form-urlencoded\n\nname=example.com&smtp_password=supersecret\n```\n\n#### Delete Domain\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\n```\n\n### Messages\n\n#### Send Message\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fmessages\nContent-Type: application\u002Fx-www-form-urlencoded\n\nfrom=sender@example.com&to=recipient@example.com&subject=Hello&text=Hello World\n```\n\nParameters:\n- `from` (required) - Sender email address\n- `to` (required) - Recipient(s), comma-separated\n- `cc` - CC recipients\n- `bcc` - BCC recipients\n- `subject` (required) - Email subject\n- `text` - Plain text body\n- `html` - HTML body\n- `template` - Name of stored template to use\n- `o:tag` - Tag for tracking\n- `o:tracking` - Enable\u002Fdisable tracking (yes\u002Fno)\n- `o:tracking-clicks` - Enable click tracking\n- `o:tracking-opens` - Enable open tracking\n- `h:X-Custom-Header` - Custom headers (prefix with h:)\n- `v:custom-var` - Custom variables for templates (prefix with v:)\n\n#### Send MIME Message\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fmessages.mime\nContent-Type: multipart\u002Fform-data\n\nto=recipient@example.com&message=\u003CMIME content>\n```\n\n### Events\n\n#### List Events\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fevents\n```\n\nQuery parameters:\n- `begin` - Start time (RFC 2822 or Unix timestamp)\n- `end` - End time\n- `ascending` - Sort order (yes\u002Fno)\n- `limit` - Results per page (max 300)\n- `event` - Filter by event type (accepted, delivered, failed, opened, clicked, unsubscribed, complained, stored)\n- `from` - Filter by sender\n- `to` - Filter by recipient\n- `tags` - Filter by tags\n\n### Routes\n\nRoutes are defined globally per account, not per domain.\n\n#### List Routes\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Froutes\n```\n\nQuery parameters:\n- `skip` - Number of records to skip\n- `limit` - Number of records to return\n\n#### Create Route\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Froutes\nContent-Type: application\u002Fx-www-form-urlencoded\n\npriority=0&description=My Route&expression=match_recipient(\".*@example.com\")&action=forward(\"https:\u002F\u002Fexample.com\u002Fwebhook\")\n```\n\nParameters:\n- `priority` - Route priority (lower = higher priority)\n- `description` - Route description\n- `expression` - Filter expression (match_recipient, match_header, catch_all)\n- `action` - Action(s) to take (forward, store, stop)\n\n#### Get Route\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Froutes\u002F{route_id}\n```\n\n#### Update Route\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Froutes\u002F{route_id}\nContent-Type: application\u002Fx-www-form-urlencoded\n\npriority=1&description=Updated Route\n```\n\n#### Delete Route\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Froutes\u002F{route_id}\n```\n\n### Webhooks\n\n#### List Webhooks\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\n```\n\n#### Create Webhook\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\nContent-Type: application\u002Fx-www-form-urlencoded\n\nid=delivered&url=https:\u002F\u002Fexample.com\u002Fwebhook\n```\n\nWebhook types: `accepted`, `delivered`, `opened`, `clicked`, `unsubscribed`, `complained`, `permanent_fail`, `temporary_fail`\n\n#### Get Webhook\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\u002F{webhook_type}\n```\n\n#### Update Webhook\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\u002F{webhook_type}\nContent-Type: application\u002Fx-www-form-urlencoded\n\nurl=https:\u002F\u002Fexample.com\u002Fnew-webhook\n```\n\n#### Delete Webhook\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\u002F{webhook_type}\n```\n\n### Templates\n\n#### List Templates\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftemplates\n```\n\n#### Create Template\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftemplates\nContent-Type: application\u002Fx-www-form-urlencoded\n\nname=my-template&description=Welcome email&template=\u003Chtml>\u003Cbody>Hello {{name}}\u003C\u002Fbody>\u003C\u002Fhtml>\n```\n\n#### Get Template\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftemplates\u002F{template_name}\n```\n\n#### Delete Template\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftemplates\u002F{template_name}\n```\n\n### Mailing Lists\n\n#### List Mailing Lists\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Flists\u002Fpages\n```\n\n#### Create Mailing List\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Flists\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=newsletter@example.com&name=Newsletter&description=Monthly newsletter&access_level=readonly\n```\n\nAccess levels: `readonly`, `members`, `everyone`\n\n#### Get Mailing List\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\n```\n\n#### Update Mailing List\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\nContent-Type: application\u002Fx-www-form-urlencoded\n\nname=Updated Newsletter\n```\n\n#### Delete Mailing List\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\n```\n\n### Mailing List Members\n\n#### List Members\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\u002Fpages\n```\n\n#### Add Member\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=member@example.com&name=John Doe&subscribed=yes\n```\n\n#### Get Member\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\u002F{member_address}\n```\n\n#### Update Member\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\u002F{member_address}\nContent-Type: application\u002Fx-www-form-urlencoded\n\nname=Jane Doe&subscribed=no\n```\n\n#### Delete Member\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\u002F{member_address}\n```\n\n### Suppressions\n\n#### Bounces\n\n```bash\n# List bounces\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fbounces\n\n# Add bounce\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fbounces\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=bounced@example.com&code=550&error=Mailbox not found\n\n# Get bounce\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fbounces\u002F{address}\n\n# Delete bounce\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fbounces\u002F{address}\n```\n\n#### Unsubscribes\n\n```bash\n# List unsubscribes\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Funsubscribes\n\n# Add unsubscribe\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Funsubscribes\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=unsubscribed@example.com&tag=*\n\n# Delete unsubscribe\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Funsubscribes\u002F{address}\n```\n\n#### Complaints\n\n```bash\n# List complaints\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fcomplaints\n\n# Add complaint\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fcomplaints\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=complainer@example.com\n\n# Delete complaint\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fcomplaints\u002F{address}\n```\n\n#### Whitelists\n\n```bash\n# List whitelists\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fwhitelists\n\n# Add to whitelist\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fwhitelists\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=allowed@example.com\n\n# Delete from whitelist\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fwhitelists\u002F{address}\n```\n\n### Statistics\n\n#### Get Stats\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fstats\u002Ftotal?event=delivered&event=opened\n```\n\nQuery parameters:\n- `event` (required) - Event type(s): accepted, delivered, failed, opened, clicked, unsubscribed, complained\n- `start` - Start date (RFC 2822 or Unix timestamp)\n- `end` - End date\n- `resolution` - Data resolution (hour, day, month)\n- `duration` - Period to show stats for\n\n### Tags\n\n#### List Tags\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftags\n```\n\n#### Get Tag\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftags\u002F{tag_name}\n```\n\n#### Delete Tag\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftags\u002F{tag_name}\n```\n\n### IPs\n\n#### List IPs\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fips\n```\n\n#### Get IP\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fips\u002F{ip_address}\n```\n\n### Domain Tracking\n\n#### Get Tracking Settings\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Ftracking\n```\n\n#### Update Open Tracking\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Ftracking\u002Fopen\nContent-Type: application\u002Fx-www-form-urlencoded\n\nactive=yes\n```\n\n#### Update Click Tracking\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Ftracking\u002Fclick\nContent-Type: application\u002Fx-www-form-urlencoded\n\nactive=yes\n```\n\n#### Update Unsubscribe Tracking\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Ftracking\u002Funsubscribe\nContent-Type: application\u002Fx-www-form-urlencoded\n\nactive=yes&html_footer=\u003Ca href=\"%unsubscribe_url%\">Unsubscribe\u003C\u002Fa>\n```\n\n### Credentials\n\n#### List Credentials\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fcredentials\n```\n\n#### Create Credential\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fcredentials\nContent-Type: application\u002Fx-www-form-urlencoded\n\nlogin=alice&password=supersecret\n```\n\n#### Delete Credential\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fcredentials\u002F{login}\n```\n\n## Pagination\n\nMailgun uses cursor-based pagination:\n\n```json\n{\n  \"items\": [...],\n  \"paging\": {\n    \"first\": \"https:\u002F\u002Fapi.mailgun.net\u002Fv3\u002F...\u002Fpages?page=first&limit=100\",\n    \"last\": \"https:\u002F\u002Fapi.mailgun.net\u002Fv3\u002F...\u002Fpages?page=last&limit=100\",\n    \"next\": \"https:\u002F\u002Fapi.mailgun.net\u002Fv3\u002F...\u002Fpages?page=next&limit=100\",\n    \"previous\": \"https:\u002F\u002Fapi.mailgun.net\u002Fv3\u002F...\u002Fpages?page=prev&limit=100\"\n  }\n}\n```\n\nUse `limit` parameter to control page size (default: 100).\n\n## Code Examples\n\n### JavaScript - Send Email\n\n```javascript\nconst formData = new URLSearchParams();\nformData.append('from', 'sender@example.com');\nformData.append('to', 'recipient@example.com');\nformData.append('subject', 'Hello');\nformData.append('text', 'Hello World!');\n\nconst response = await fetch(\n  'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fexample.com\u002Fmessages',\n  {\n    method: 'POST',\n    headers: {\n      'Authorization': `Bearer ${process.env.MATON_API_KEY}`,\n      'Content-Type': 'application\u002Fx-www-form-urlencoded'\n    },\n    body: formData.toString()\n  }\n);\nconst result = await response.json();\nconsole.log(result);\n```\n\n### Python - Send Email\n\n```python\nimport os\nimport requests\n\nresponse = requests.post(\n    'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fexample.com\u002Fmessages',\n    headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'},\n    data={\n        'from': 'sender@example.com',\n        'to': 'recipient@example.com',\n        'subject': 'Hello',\n        'text': 'Hello World!'\n    }\n)\nprint(response.json())\n```\n\n### Python - List Domains\n\n```python\nimport os\nimport requests\n\nresponse = requests.get(\n    'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains',\n    headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'}\n)\ndomains = response.json()\nfor domain in domains['items']:\n    print(f\"{domain['name']}: {domain['state']}\")\n```\n\n### Python - Create Route and Webhook\n\n```python\nimport os\nimport requests\n\nheaders = {'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'}\ndomain = 'example.com'\n\n# Create route\nroute_response = requests.post(\n    'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Froutes',\n    headers=headers,\n    data={\n        'priority': 0,\n        'description': 'Forward to webhook',\n        'expression': 'match_recipient(\"support@example.com\")',\n        'action': 'forward(\"https:\u002F\u002Fmyapp.com\u002Fincoming-email\")'\n    }\n)\nprint(f\"Route created: {route_response.json()}\")\n\n# Create webhook\nwebhook_response = requests.post(\n    f'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain}\u002Fwebhooks',\n    headers=headers,\n    data={\n        'id': 'delivered',\n        'url': 'https:\u002F\u002Fmyapp.com\u002Fwebhook\u002Fdelivered'\n    }\n)\nprint(f\"Webhook created: {webhook_response.json()}\")\n```\n\n## Notes\n\n- Mailgun uses `application\u002Fx-www-form-urlencoded` for POST\u002FPUT requests, not JSON\n- Domain names must be included in most endpoint paths\n- Routes are global (per account), not per domain\n- Sandbox domains require authorized recipients for sending\n- Dates are returned in RFC 2822 format\n- Event logs are stored for at least 3 days\n- Stats require at least one `event` parameter\n- Templates use Handlebars syntax by default\n- IMPORTANT: When using curl commands, use `curl -g` when URLs contain brackets to disable glob parsing\n- IMPORTANT: When piping curl output to `jq`, environment variables may not expand correctly. Use Python examples instead.\n\n## Rate Limits\n\n| Operation | Limit |\n|-----------|-------|\n| Sending | Varies by plan |\n| API calls | No hard limit, but excessive requests may be throttled |\n\nWhen rate limited, implement exponential backoff for retries.\n\n## Error Handling\n\n| Status | Meaning |\n|--------|---------|\n| 400 | Bad request or missing Mailgun connection |\n| 401 | Invalid or missing Maton API key |\n| 403 | Forbidden (e.g., sandbox domain restrictions) |\n| 404 | Resource not found |\n| 429 | Rate limited |\n| 4xx\u002F5xx | Passthrough error from Mailgun API |\n\n### Troubleshooting: API Key Issues\n\n1. Check that the `MATON_API_KEY` environment variable is set:\n\n```bash\necho $MATON_API_KEY\n```\n\n2. Verify the API key is valid by listing connections:\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Troubleshooting: Invalid App Name\n\n1. Ensure your URL path starts with `mailgun`. For example:\n\n- Correct: `https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains`\n- Incorrect: `https:\u002F\u002Fgateway.maton.ai\u002Fv3\u002Fdomains`\n\n### Troubleshooting: Sandbox Domain Restrictions\n\nSandbox domains can only send to authorized recipients. To send emails:\n1. Upgrade to a paid plan, or\n2. Add recipient addresses to authorized recipients in the Mailgun dashboard\n\n## Resources\n\n- [Mailgun API Documentation](https:\u002F\u002Fdocumentation.mailgun.com\u002Fdocs\u002Fmailgun\u002Fapi-reference\u002Fapi-overview)\n- [Mailgun API Reference](https:\u002F\u002Fmailgun-docs.redoc.ly\u002Fdocs\u002Fmailgun\u002Fapi-reference\u002Fintro\u002F)\n- [Mailgun Postman Collection](https:\u002F\u002Fwww.postman.com\u002Fmailgun\u002Fmailgun-s-public-workspace\u002Fdocumentation\u002Fik8dl61\u002Fmailgun-api)\n- [Maton Community](https:\u002F\u002Fdiscord.com\u002Finvite\u002FdBfFAcefs2)\n- [Maton Support](mailto:support@maton.ai)\n","# Mailgun\n\nAccess the Mailgun API with managed OAuth authentication. Send transactional emails, manage domains, routes, templates, mailing lists, suppressions, and webhooks.\n\n## Quick Start\n\n```bash\n# List domains\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n## Base URL\n\n```\nhttps:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002F{resource}\n```\n\nReplace `{resource}` with the actual Mailgun API endpoint path. The gateway proxies requests to `api.mailgun.net\u002Fv3` (US region) and automatically injects your OAuth token.\n\n**Regional Note:** Mailgun has US and EU regions. The gateway defaults to US region (api.mailgun.net).\n\n## Authentication\n\nAll requests require the Maton API key in the Authorization header:\n\n```\nAuthorization: Bearer $MATON_API_KEY\n```\n\n**Environment Variable:** Set your API key as `MATON_API_KEY`:\n\n```bash\nexport MATON_API_KEY=\"YOUR_API_KEY\"\n```\n\n### Getting Your API Key\n\n1. Sign in or create an account at [maton.ai](https:\u002F\u002Fmaton.ai)\n2. Go to [maton.ai\u002Fsettings](https:\u002F\u002Fmaton.ai\u002Fsettings)\n3. Copy your API key\n\n## Connection Management\n\nManage your Mailgun OAuth connections at `https:\u002F\u002Fctrl.maton.ai`.\n\n### List Connections\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections?app=mailgun&status=ACTIVE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Create Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'app': 'mailgun'}).encode()\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application\u002Fjson')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Get Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections\u002F{connection_id}')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n**Response:**\n```json\n{\n  \"connection\": {\n    \"connection_id\": \"78b5a036-c621-40c2-b74b-276195735af2\",\n    \"status\": \"ACTIVE\",\n    \"creation_time\": \"2026-02-12T02:24:16.551210Z\",\n    \"last_updated_time\": \"2026-02-12T02:25:03.542838Z\",\n    \"url\": \"https:\u002F\u002Fconnect.maton.ai\u002F?session_token=...\",\n    \"app\": \"mailgun\",\n    \"metadata\": {}\n  }\n}\n```\n\nOpen the returned `url` in a browser to complete OAuth authorization.\n\n### Delete Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections\u002F{connection_id}', method='DELETE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Specifying Connection\n\nIf you have multiple Mailgun connections, specify which one to use with the `Maton-Connection` header:\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Maton-Connection', '78b5a036-c621-40c2-b74b-276195735af2')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\nIf omitted, the gateway uses the default (oldest) active connection.\n\n## API Reference\n\n**Important:** Mailgun API uses `application\u002Fx-www-form-urlencoded` for POST\u002FPUT requests, not JSON.\n\n### Domains\n\n#### List Domains\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\n```\n\nReturns all domains for the account.\n\n#### Get Domain\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\n```\n\n#### Create Domain\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Fdomains\nContent-Type: application\u002Fx-www-form-urlencoded\n\nname=example.com&smtp_password=supersecret\n```\n\n#### Delete Domain\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\n```\n\n### Messages\n\n#### Send Message\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fmessages\nContent-Type: application\u002Fx-www-form-urlencoded\n\nfrom=sender@example.com&to=recipient@example.com&subject=Hello&text=Hello World\n```\n\nParameters:\n- `from` (required) - Sender email address\n- `to` (required) - Recipient(s), comma-separated\n- `cc` - CC recipients\n- `bcc` - BCC recipients\n- `subject` (required) - Email subject\n- `text` - Plain text body\n- `html` - HTML body\n- `template` - Name of stored template to use\n- `o:tag` - Tag for tracking\n- `o:tracking` - Enable\u002Fdisable tracking (yes\u002Fno)\n- `o:tracking-clicks` - Enable click tracking\n- `o:tracking-opens` - Enable open tracking\n- `h:X-Custom-Header` - Custom headers (prefix with h:)\n- `v:custom-var` - Custom variables for templates (prefix with v:)\n\n#### Send MIME Message\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fmessages.mime\nContent-Type: multipart\u002Fform-data\n\nto=recipient@example.com&message=\u003CMIME content>\n```\n\n### Events\n\n#### List Events\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fevents\n```\n\nQuery parameters:\n- `begin` - Start time (RFC 2822 or Unix timestamp)\n- `end` - End time\n- `ascending` - Sort order (yes\u002Fno)\n- `limit` - Results per page (max 300)\n- `event` - Filter by event type (accepted, delivered, failed, opened, clicked, unsubscribed, complained, stored)\n- `from` - Filter by sender\n- `to` - Filter by recipient\n- `tags` - Filter by tags\n\n### Routes\n\nRoutes are defined globally per account, not per domain.\n\n#### List Routes\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Froutes\n```\n\nQuery parameters:\n- `skip` - Number of records to skip\n- `limit` - Number of records to return\n\n#### Create Route\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Froutes\nContent-Type: application\u002Fx-www-form-urlencoded\n\npriority=0&description=My Route&expression=match_recipient(\".*@example.com\")&action=forward(\"https:\u002F\u002Fexample.com\u002Fwebhook\")\n```\n\nParameters:\n- `priority` - Route priority (lower = higher priority)\n- `description` - Route description\n- `expression` - Filter expression (match_recipient, match_header, catch_all)\n- `action` - Action(s) to take (forward, store, stop)\n\n#### Get Route\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Froutes\u002F{route_id}\n```\n\n#### Update Route\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Froutes\u002F{route_id}\nContent-Type: application\u002Fx-www-form-urlencoded\n\npriority=1&description=Updated Route\n```\n\n#### Delete Route\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Froutes\u002F{route_id}\n```\n\n### Webhooks\n\n#### List Webhooks\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\n```\n\n#### Create Webhook\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\nContent-Type: application\u002Fx-www-form-urlencoded\n\nid=delivered&url=https:\u002F\u002Fexample.com\u002Fwebhook\n```\n\nWebhook types: `accepted`, `delivered`, `opened`, `clicked`, `unsubscribed`, `complained`, `permanent_fail`, `temporary_fail`\n\n#### Get Webhook\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\u002F{webhook_type}\n```\n\n#### Update Webhook\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\u002F{webhook_type}\nContent-Type: application\u002Fx-www-form-urlencoded\n\nurl=https:\u002F\u002Fexample.com\u002Fnew-webhook\n```\n\n#### Delete Webhook\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fwebhooks\u002F{webhook_type}\n```\n\n### Templates\n\n#### List Templates\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftemplates\n```\n\n#### Create Template\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftemplates\nContent-Type: application\u002Fx-www-form-urlencoded\n\nname=my-template&description=Welcome email&template=\u003Chtml>\u003Cbody>Hello {{name}}\u003C\u002Fbody>\u003C\u002Fhtml>\n```\n\n#### Get Template\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftemplates\u002F{template_name}\n```\n\n#### Delete Template\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftemplates\u002F{template_name}\n```\n\n### Mailing Lists\n\n#### List Mailing Lists\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Flists\u002Fpages\n```\n\n#### Create Mailing List\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Flists\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=newsletter@example.com&name=Newsletter&description=Monthly newsletter&access_level=readonly\n```\n\nAccess levels: `readonly`, `members`, `everyone`\n\n#### Get Mailing List\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\n```\n\n#### Update Mailing List\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\nContent-Type: application\u002Fx-www-form-urlencoded\n\nname=Updated Newsletter\n```\n\n#### Delete Mailing List\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\n```\n\n### Mailing List Members\n\n#### List Members\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\u002Fpages\n```\n\n#### Add Member\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=member@example.com&name=John Doe&subscribed=yes\n```\n\n#### Get Member\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\u002F{member_address}\n```\n\n#### Update Member\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\u002F{member_address}\nContent-Type: application\u002Fx-www-form-urlencoded\n\nname=Jane Doe&subscribed=no\n```\n\n#### Delete Member\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Flists\u002F{list_address}\u002Fmembers\u002F{member_address}\n```\n\n### Suppressions\n\n#### Bounces\n\n```bash\n# List bounces\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fbounces\n\n# Add bounce\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fbounces\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=bounced@example.com&code=550&error=Mailbox not found\n\n# Get bounce\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fbounces\u002F{address}\n\n# Delete bounce\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fbounces\u002F{address}\n```\n\n#### Unsubscribes\n\n```bash\n# List unsubscribes\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Funsubscribes\n\n# Add unsubscribe\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Funsubscribes\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=unsubscribed@example.com&tag=*\n\n# Delete unsubscribe\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Funsubscribes\u002F{address}\n```\n\n#### Complaints\n\n```bash\n# List complaints\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fcomplaints\n\n# Add complaint\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fcomplaints\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=complainer@example.com\n\n# Delete complaint\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fcomplaints\u002F{address}\n```\n\n#### Whitelists\n\n```bash\n# List whitelists\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fwhitelists\n\n# Add to whitelist\nPOST \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fwhitelists\nContent-Type: application\u002Fx-www-form-urlencoded\n\naddress=allowed@example.com\n\n# Delete from whitelist\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fwhitelists\u002F{address}\n```\n\n### Statistics\n\n#### Get Stats\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Fstats\u002Ftotal?event=delivered&event=opened\n```\n\nQuery parameters:\n- `event` (required) - Event type(s): accepted, delivered, failed, opened, clicked, unsubscribed, complained\n- `start` - Start date (RFC 2822 or Unix timestamp)\n- `end` - End date\n- `resolution` - Data resolution (hour, day, month)\n- `duration` - Period to show stats for\n\n### Tags\n\n#### List Tags\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftags\n```\n\n#### Get Tag\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftags\u002F{tag_name}\n```\n\n#### Delete Tag\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002F{domain_name}\u002Ftags\u002F{tag_name}\n```\n\n### IPs\n\n#### List IPs\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fips\n```\n\n#### Get IP\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fips\u002F{ip_address}\n```\n\n### Domain Tracking\n\n#### Get Tracking Settings\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Ftracking\n```\n\n#### Update Open Tracking\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Ftracking\u002Fopen\nContent-Type: application\u002Fx-www-form-urlencoded\n\nactive=yes\n```\n\n#### Update Click Tracking\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Ftracking\u002Fclick\nContent-Type: application\u002Fx-www-form-urlencoded\n\nactive=yes\n```\n\n#### Update Unsubscribe Tracking\n\n```bash\nPUT \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Ftracking\u002Funsubscribe\nContent-Type: application\u002Fx-www-form-urlencoded\n\nactive=yes&html_footer=\u003Ca href=\"%unsubscribe_url%\">Unsubscribe\u003C\u002Fa>\n```\n\n### Credentials\n\n#### List Credentials\n\n```bash\nGET \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fcredentials\n```\n\n#### Create Credential\n\n```bash\nPOST \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fcredentials\nContent-Type: application\u002Fx-www-form-urlencoded\n\nlogin=alice&password=supersecret\n```\n\n#### Delete Credential\n\n```bash\nDELETE \u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain_name}\u002Fcredentials\u002F{login}\n```\n\n## Pagination\n\nMailgun uses cursor-based pagination:\n\n```json\n{\n  \"items\": [...],\n  \"paging\": {\n    \"first\": \"https:\u002F\u002Fapi.mailgun.net\u002Fv3\u002F...\u002Fpages?page=first&limit=100\",\n    \"last\": \"https:\u002F\u002Fapi.mailgun.net\u002Fv3\u002F...\u002Fpages?page=last&limit=100\",\n    \"next\": \"https:\u002F\u002Fapi.mailgun.net\u002Fv3\u002F...\u002Fpages?page=next&limit=100\",\n    \"previous\": \"https:\u002F\u002Fapi.mailgun.net\u002Fv3\u002F...\u002Fpages?page=prev&limit=100\"\n  }\n}\n```\n\nUse `limit` parameter to control page size (default: 100).\n\n## Code Examples\n\n### JavaScript - Send Email\n\n```javascript\nconst formData = new URLSearchParams();\nformData.append('from', 'sender@example.com');\nformData.append('to', 'recipient@example.com');\nformData.append('subject', 'Hello');\nformData.append('text', 'Hello World!');\n\nconst response = await fetch(\n  'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fexample.com\u002Fmessages',\n  {\n    method: 'POST',\n    headers: {\n      'Authorization': `Bearer ${process.env.MATON_API_KEY}`,\n      'Content-Type': 'application\u002Fx-www-form-urlencoded'\n    },\n    body: formData.toString()\n  }\n);\nconst result = await response.json();\nconsole.log(result);\n```\n\n### Python - Send Email\n\n```python\nimport os\nimport requests\n\nresponse = requests.post(\n    'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fexample.com\u002Fmessages',\n    headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'},\n    data={\n        'from': 'sender@example.com',\n        'to': 'recipient@example.com',\n        'subject': 'Hello',\n        'text': 'Hello World!'\n    }\n)\nprint(response.json())\n```\n\n### Python - List Domains\n\n```python\nimport os\nimport requests\n\nresponse = requests.get(\n    'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains',\n    headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'}\n)\ndomains = response.json()\nfor domain in domains['items']:\n    print(f\"{domain['name']}: {domain['state']}\")\n```\n\n### Python - Create Route and Webhook\n\n```python\nimport os\nimport requests\n\nheaders = {'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'}\ndomain = 'example.com'\n\n# Create route\nroute_response = requests.post(\n    'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Froutes',\n    headers=headers,\n    data={\n        'priority': 0,\n        'description': 'Forward to webhook',\n        'expression': 'match_recipient(\"support@example.com\")',\n        'action': 'forward(\"https:\u002F\u002Fmyapp.com\u002Fincoming-email\")'\n    }\n)\nprint(f\"Route created: {route_response.json()}\")\n\n# Create webhook\nwebhook_response = requests.post(\n    f'https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains\u002F{domain}\u002Fwebhooks',\n    headers=headers,\n    data={\n        'id': 'delivered',\n        'url': 'https:\u002F\u002Fmyapp.com\u002Fwebhook\u002Fdelivered'\n    }\n)\nprint(f\"Webhook created: {webhook_response.json()}\")\n```\n\n## Notes\n\n- Mailgun uses `application\u002Fx-www-form-urlencoded` for POST\u002FPUT requests, not JSON\n- Domain names must be included in most endpoint paths\n- Routes are global (per account), not per domain\n- Sandbox domains require authorized recipients for sending\n- Dates are returned in RFC 2822 format\n- Event logs are stored for at least 3 days\n- Stats require at least one `event` parameter\n- Templates use Handlebars syntax by default\n- IMPORTANT: When using curl commands, use `curl -g` when URLs contain brackets to disable glob parsing\n- IMPORTANT: When piping curl output to `jq`, environment variables may not expand correctly. Use Python examples instead.\n\n## Rate Limits\n\n| Operation | Limit |\n|-----------|-------|\n| Sending | Varies by plan |\n| API calls | No hard limit, but excessive requests may be throttled |\n\nWhen rate limited, implement exponential backoff for retries.\n\n## Error Handling\n\n| Status | Meaning |\n|--------|---------|\n| 400 | Bad request or missing Mailgun connection |\n| 401 | Invalid or missing Maton API key |\n| 403 | Forbidden (e.g., sandbox domain restrictions) |\n| 404 | Resource not found |\n| 429 | Rate limited |\n| 4xx\u002F5xx | Passthrough error from Mailgun API |\n\n### Troubleshooting: API Key Issues\n\n1. Check that the `MATON_API_KEY` environment variable is set:\n\n```bash\necho $MATON_API_KEY\n```\n\n2. Verify the API key is valid by listing connections:\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Troubleshooting: Invalid App Name\n\n1. Ensure your URL path starts with `mailgun`. For example:\n\n- Correct: `https:\u002F\u002Fgateway.maton.ai\u002Fmailgun\u002Fv3\u002Fdomains`\n- Incorrect: `https:\u002F\u002Fgateway.maton.ai\u002Fv3\u002Fdomains`\n\n### Troubleshooting: Sandbox Domain Restrictions\n\nSandbox domains can only send to authorized recipients. To send emails:\n1. Upgrade to a paid plan, or\n2. Add recipient addresses to authorized recipients in the Mailgun dashboard\n\n## Resources\n\n- [Mailgun API Documentation](https:\u002F\u002Fdocumentation.mailgun.com\u002Fdocs\u002Fmailgun\u002Fapi-reference\u002Fapi-overview)\n- [Mailgun API Reference](https:\u002F\u002Fmailgun-docs.redoc.ly\u002Fdocs\u002Fmailgun\u002Fapi-reference\u002Fintro\u002F)\n- [Mailgun Postman Collection](https:\u002F\u002Fwww.postman.com\u002Fmailgun\u002Fmailgun-s-public-workspace\u002Fdocumentation\u002Fik8dl61\u002Fmailgun-api)\n- [Maton Community](https:\u002F\u002Fdiscord.com\u002Finvite\u002FdBfFAcefs2)\n- [Maton Support](mailto:support@maton.ai)\n",{"name":5,"metadata":24,"description":33,"compatibility":34},{"author":25,"version":26,"clawdbot":27},"maton","1.0",{"emoji":28,"homepage":29,"requires":30},"🧠","https:\u002F\u002Fmaton.ai",{"env":31},[32],"MATON_API_KEY","Mailgun API integration with managed OAuth. Transactional email service for sending, receiving, and tracking emails.\nUse this skill when users want to send emails, manage domains, routes, templates, mailing lists, or suppressions in Mailgun.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\n","Requires network access and valid Maton API key","main","54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44",".agents\u002Fskills\u002Fmailgun","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal","https:\u002F\u002Fgithub.com\u002Fmeghal86","2026-05-17 14:11:28",{"source":8,"skillName":5,"commands":42,"prompt":52,"zipAvailable":53},[43,46,49],{"tool":44,"command":45},"npx","npx skills add meghal86\u002Fstacksignal --skill mailgun",{"tool":47,"command":48},"bunx","bunx skills add meghal86\u002Fstacksignal --skill mailgun",{"tool":50,"command":51},"pnpm","pnpm dlx skills add meghal86\u002Fstacksignal --skill mailgun","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fmailgun\u002FSKILL.md",true,[55,61],{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"_meta.json","REFERENCE","参考文档",272,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fmailgun\u002F_meta.json",{"path":62,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":65,"sourceHtmlUrl":15},"LICENSE.txt","LICENSE","许可证",1072,[67,76,84,92,100,107],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":71,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":75},"01M78XH0FRP65NYEDHF2BT7NB1","zvukogram","Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzvukogram\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzvukogram\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":80,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":75},"01M78XEND5ASXYB6MN8AQQGJAF","zohomail","Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels.\nUse this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzohomail\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzohomail\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":75},"01M78XEBBV3C6DRZFAJXP6RDKS","zoho-recruit","Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows.\nUse this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-recruit\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-recruit\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":75},"01M78XE5CQG75DZWYSKGXFR99T","zoho-people","Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave.\nUse this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-people\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-people\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":103,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":75},"01M78XDZKMZAJYFJJFT7MR5ZN2","zoho-mail","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-mail\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-mail\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":111,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":75},"01M78XDST8JK0WVDA1F3VPNWXD","zoho-inventory","Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments.\nUse this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-inventory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-inventory\u002FSKILL.md",[],[]]