Files
hermes-skills/skills/email/email-workflows/references/mxroute-api-and-directadmin.md
T

2.0 KiB

MXroute API vs DirectAdmin

Two separate systems

MXroute provides TWO authentication paths for management:

System Auth Capabilities
MXroute API (api.mxroute.com) API key (Mx8e3b9a...) + server (heracles.mxrouting.net) + username (itpropar) Domain management only — list, add, delete domains. Toggle mail on/off. Get verification keys.
DirectAdmin (heracles.mxrouting.net:2222) Username (itpropar) + password (__P1NeW=z^Zx) Full email account CRUD — create/delete mailboxes, reset passwords, manage forwarding, quotas

MXroute API key — domain management only

curl -s https://api.mxroute.com/domains \
  -H "X-Server: heracles.mxrouting.net" \
  -H "X-Username: itpropar" \
  -H "X-API-Key: Mx8e3b9a108a2188d958741ffd1311K1"

Available endpoints (from api.mxroute.com/docs):

  • GET /domains — list domains
  • POST /domains — add domain
  • GET /domains/{domain} — domain details
  • DELETE /domains/{domain} — remove domain
  • PATCH /domains/{domain}/mail-status — enable/disable mail
  • GET /verification-key — domain verification key

Not available through API key: email account listing, creation, deletion, password resets, quota checks.

DirectAdmin — email account CRUD

curl -sku "itpropar:__P1NeW=z^Zx" \
  "https://heracles.mxrouting.net:2222/CMD_API_POP?domain=germainebrown.com&action=list"

Rate limits from docs: 100 read requests/min, 20 write requests/min.

9 domains on the account

germainebrown.com        → g@, shonuff@
iamgmb.com               → garrison@, greyson@
itpropartner.com         → (not on MXroute — SiteGround MX)
debtrecoveryexperts.com  → collections@, dre@, hello@
boxpilotlogistics.com
fleettrack360.com
vigilanttac.com
voipsimplicity.com
theunlearningcircle.com

SMTP relay

MXroute blocks direct SMTP from our IP. Relay through:

mail.germainebrown.com:2525 STARTTLS

Use per-account email passwords (set via DirectAdmin), NOT the API key or DirectAdmin credentials.