Mailgun Email API

Overview

Mailgun (by Sinch) provides REST API and SMTP relay for transactional and bulk email — sending, receiving, tracking, and suppression management.

Agent Instructions

Before generating code, gather from the user (skip any item already specified in the prompt or context):

1. Region — US or EU. Region determines the base URL and cannot be changed after domain creation.
2. Approach — SDK or direct API calls (curl/fetch/requests)?
3. Language — for SDK: Node.js (mailgun.js). For direct API: any language, or curl. Other languages must use direct HTTP — there is no first-party SDK wrapper.
4. Before generating code, check for existing .env files or environment variables for MAILGUN_API_KEY and MAILGUN_DOMAIN.

Product gotchas to apply unconditionally:

• For events, logs, stats, or tags — use the current /v1/analytics/* APIs, never the deprecated v3 endpoints.
• For domain CRUD operations, use /v4/domains (not v3).