{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"9f5f6bbe05c328ab74afce8daa515d58ab6a95a0b4932b82bed662a863a32346","entry":{"id":"mailgun/email","name":"Mailgun email API","vendor":"Mailgun","summary":"Email sending API from Mailgun (Sinch). Verify your domain with SPF, DKIM, MX and tracking CNAME records, then use the account key or a domain sending key.","category":"email","group":"A","homepage":"https://www.mailgun.com/","docs":["https://documentation.mailgun.com/"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"verify","url":"https://documentation.mailgun.com/docs/mailgun/user-manual/domains/domains-verify","title":"Mailgun docs - Verify your domain","accessed":"2026-10-25","supports":"Required records TXT SPF v=spf1 include:mailgun.org ~all, DKIM TXT from control panel, tracking CNAME to mailgun.org, MX priority 10 mxa.mailgun.org and mxb.mailgun.org; Verify DNS settings; 24-48 hours propagation; DKIM unverified keys note; verified domains exempt from the 300 emails per day limit","kind":"official"},{"id":"auth","url":"https://documentation.mailgun.com/docs/mailgun/api-reference/authentication","title":"Mailgun docs - Authentication","accessed":"2026-10-25","supports":"Basic auth user api; primary account API key at Account Settings > API Keys; Domain Sending Key limited to /messages for one domain, created in Domain Settings > Sending API keys, shown only once","kind":"official"},{"id":"node-sdk","url":"https://documentation.mailgun.com/docs/mailgun/sdk/nodejs_sdk","title":"Mailgun docs - Node.js SDK","accessed":"2026-10-25","supports":"MAILGUN_API_KEY env var in examples; EU url option https://api.eu.mailgun.net","kind":"official"},{"id":"pricing","url":"https://www.mailgun.com/pricing/","title":"Mailgun pricing","accessed":"2026-10-25","supports":"Free $0 with 100 emails/day; Basic from $15/mo for 10,000 emails; Foundation $35/mo; Scale $90/mo","kind":"official"},{"id":"aup","url":"https://www.mailgun.com/legal/aup/","title":"Sinch Email (Mailgun) Acceptable Use Policy","accessed":"2026-10-25","supports":"Third-party lists prohibited; clear, explicit, provable consent; proof of consent on escalated complaints; thresholds bounces <=5%, spam complaints <=0.08%, blocks <20%, unsubscribes <=1.4%","kind":"official"}],"allowed_domains":["mailgun.com"],"prerequisites":[{"need":"A domain you control with access to its DNS settings"}],"have_ready":[{"kind":"other","description":"DNS access for the sending domain","why":"SPF, DKIM, MX and CNAME records are required to verify the domain.","needed_for":["add-dns-records"],"auto_check":"dns_record","source":"verify"}],"steps":[{"id":"sign-in","title":"Sign in or create a Mailgun account","summary":"Sign in to Mailgun. If you have no account yet, you create it yourself; verapli does not create accounts.","route":"guided","depends_on":[],"gate":"human_login","url":"https://login.mailgun.com/login/"},{"id":"add-domain","title":"Add your sending domain","summary":"In Sending > Domains add your domain (choose the US or EU region; EU uses api.eu.mailgun.net).","route":"guided","depends_on":["sign-in"],"gate":"human_submit","sources":["verify","node-sdk"]},{"id":"add-dns-records","title":"Add SPF, DKIM, MX and tracking records","summary":"Add the TXT SPF record (v=spf1 include:mailgun.org ~all), the DKIM TXT record shown in Domain Verification & DNS, MX records (priority 10) for mxa.mailgun.org and mxb.mailgun.org, and the tracking CNAME to mailgun.org. Then click Verify DNS settings.","route":"guided","depends_on":["add-domain"],"gate":"none","lead_time":{"official":{"text":"DNS changes can take 24-48 hours to fully propagate.","source":"verify"}},"preflight":[{"rule":"dns_record_resolves","params":{"name":"{domain}","type":"TXT","value":"v=spf1 include:mailgun.org ~all"}}],"recovery":[{"hiccup":"Some DKIM keys show Unverified","fix":"Not every listed key must verify; make sure the key your domain configuration uses is correct in DNS.","source":"verify"},{"hiccup":"Verification has not completed","fix":"Confirm the records exist, allow for propagation, then run Verify DNS settings again.","source":"verify"}],"sources":["verify"]},{"id":"create-sending-key","title":"Create a domain sending key","summary":"In Domain Settings > Sending API keys click Add Sending Key. It can only send for that domain. It is shown only once. (The primary account key in Account Settings > API Keys has full access.)","route":"guided","depends_on":["add-domain"],"gate":"human_submit","capture":{"env":"MAILGUN_API_KEY","kind":"api_key"},"sources":["auth","node-sdk"]}],"outputs":[{"name":"MAILGUN_API_KEY","description":"Mailgun API key (domain sending key recommended)","secret":true,"from_step":"create-sending-key"}],"terms_notes":[{"kind":"rules_say","severity":"red","title":"Consent required, no third-party lists","text":"Non-transactional mail only to recipients with clear, explicit and provable consent; acquiring or sending to third-party lists is prohibited.","source":"aup"},{"kind":"rules_say","severity":"amber","title":"Sending thresholds","text":"Keep bounces at or below 5%, spam complaints at or below 0.08% and blocks below 20%.","source":"aup"}],"pricing_notes":{"free_tier":"100 emails/day.","costs":"Basic from $15/month (10,000 emails); Foundation $35/month (50,000); Scale $90/month (100,000).","source":"pricing"},"stripe_projects":false,"api_provisioning":{"available":"partial","notes":"Domains, DNS checks and keys have API endpoints; account sign-up and DNS edits are manual.","source":"verify"},"detect":{"env_names":["MAILGUN_API_KEY"],"packages":["mailgun.js"]}}}