openclaw-backups/skills/api-gateway/references/mailgun.md

Mailgun Routing Reference

App name: mailgun Base URL proxied: api.mailgun.net

API Path Pattern

/mailgun/v3/{resource}

Common Endpoints

Domains

List Domains

GET /mailgun/v3/domains

Get Domain

GET /mailgun/v3/domains/{domain_name}

Create Domain

POST /mailgun/v3/domains

Delete Domain

DELETE /mailgun/v3/domains/{domain_name}

Messages

Send Message

POST /mailgun/v3/{domain_name}/messages

Send MIME Message

POST /mailgun/v3/{domain_name}/messages.mime

Events

List Events

GET /mailgun/v3/{domain_name}/events

Routes

List Routes

GET /mailgun/v3/routes

Create Route

POST /mailgun/v3/routes

Get Route

GET /mailgun/v3/routes/{route_id}

Update Route

PUT /mailgun/v3/routes/{route_id}

Delete Route

DELETE /mailgun/v3/routes/{route_id}

Webhooks

List Webhooks

GET /mailgun/v3/domains/{domain_name}/webhooks

Create Webhook

POST /mailgun/v3/domains/{domain_name}/webhooks

Get Webhook

GET /mailgun/v3/domains/{domain_name}/webhooks/{webhook_type}

Update Webhook

PUT /mailgun/v3/domains/{domain_name}/webhooks/{webhook_type}

Delete Webhook

DELETE /mailgun/v3/domains/{domain_name}/webhooks/{webhook_type}

Templates

List Templates

GET /mailgun/v3/{domain_name}/templates

Create Template

POST /mailgun/v3/{domain_name}/templates

Get Template

GET /mailgun/v3/{domain_name}/templates/{template_name}

Delete Template

DELETE /mailgun/v3/{domain_name}/templates/{template_name}

Mailing Lists

List Mailing Lists

GET /mailgun/v3/lists/pages

Create Mailing List

POST /mailgun/v3/lists

Get Mailing List

GET /mailgun/v3/lists/{list_address}

Update Mailing List

PUT /mailgun/v3/lists/{list_address}

Delete Mailing List

DELETE /mailgun/v3/lists/{list_address}

Mailing List Members

List Members

GET /mailgun/v3/lists/{list_address}/members/pages

Add Member

POST /mailgun/v3/lists/{list_address}/members

Get Member

GET /mailgun/v3/lists/{list_address}/members/{member_address}

Update Member

PUT /mailgun/v3/lists/{list_address}/members/{member_address}

Delete Member

DELETE /mailgun/v3/lists/{list_address}/members/{member_address}

Suppressions

Bounces

GET /mailgun/v3/{domain_name}/bounces
POST /mailgun/v3/{domain_name}/bounces
GET /mailgun/v3/{domain_name}/bounces/{address}
DELETE /mailgun/v3/{domain_name}/bounces/{address}

Unsubscribes

GET /mailgun/v3/{domain_name}/unsubscribes
POST /mailgun/v3/{domain_name}/unsubscribes
DELETE /mailgun/v3/{domain_name}/unsubscribes/{address}

Complaints

GET /mailgun/v3/{domain_name}/complaints
POST /mailgun/v3/{domain_name}/complaints
DELETE /mailgun/v3/{domain_name}/complaints/{address}

Whitelists

GET /mailgun/v3/{domain_name}/whitelists
POST /mailgun/v3/{domain_name}/whitelists
DELETE /mailgun/v3/{domain_name}/whitelists/{address}

Statistics

Get Stats

GET /mailgun/v3/{domain_name}/stats/total?event=delivered

Tags

List Tags

GET /mailgun/v3/{domain_name}/tags

Get Tag

GET /mailgun/v3/{domain_name}/tags/{tag_name}

Delete Tag

DELETE /mailgun/v3/{domain_name}/tags/{tag_name}

IPs

List IPs

GET /mailgun/v3/ips

Get IP

GET /mailgun/v3/ips/{ip_address}

Domain Tracking

Get Tracking Settings

GET /mailgun/v3/domains/{domain_name}/tracking

Update Tracking

PUT /mailgun/v3/domains/{domain_name}/tracking/open
PUT /mailgun/v3/domains/{domain_name}/tracking/click
PUT /mailgun/v3/domains/{domain_name}/tracking/unsubscribe

Credentials

List Credentials

GET /mailgun/v3/domains/{domain_name}/credentials

Create Credential

POST /mailgun/v3/domains/{domain_name}/credentials

Delete Credential

DELETE /mailgun/v3/domains/{domain_name}/credentials/{login}

Notes

• Mailgun uses application/x-www-form-urlencoded for POST/PUT requests, not JSON
• Routes are global (per account), not per domain
• Sandbox domains require authorized recipients
• Event logs stored for at least 3 days
• Stats require at least one event parameter
• US region: api.mailgun.net, EU region: api.eu.mailgun.net

Resources

• Mailgun API Documentation