API Documentation Print

  • api
  • 320

ForwardMX has a fully featured API that is available on all account tiers, allowing you to add/update/delete domains and aliases from your applications.

It uses HTTP GET or HTTP POST with standard form field elements to receive the data, and returns a JSON object.

We also have a WordPress plugin and Ruby Gem, as well as an unofficial PHP/Composer library from Eduard Wiesner and an unofficial Clojure library from ianjs.

GET/POST https://forwardmx.net/api/domains/

Returns a list of all your domains

key required Your API Key (Login and see your account page)
[  
   {  
      "domain":"example.com",
      "status":"active"
   }
]
GET/POST https://forwardmx.net/api/forwarders/

Returns a list of all aliases for a domain

key required Your API Key (Login and see your account page)
domain required A domain you want the aliases for
[  
   {  
      "source":"@",
      "destination":"[email protected]",
   }
]
GET/POST https://forwardmx.net/api/domain/create/

Create a new domain on your account

key required Your API Key (Login and see your account page)
domain required A domain you want to add to your account
{"ok": "$Message"}
{"error": "$Message"}
GET/POST https://forwardmx.net/api/domain/destroy/

Destroy a domain from your account

key required Your API Key (Login and see your account page)
domain required A domain you want to destroy
{"ok": "$Message"}
{"error": "$Message"}
GET/POST https://forwardmx.net/api/forwarders/create/

Create a new forwarder on your account/domain

key required Your API Key (Login and see your account page)
domain required A domain on which you want to edit the alias
user required Any username without @domain
destination required A email address the messages should be forwarded to
{"ok": "$Message"}
{"error": "$Message"}
GET/POST https://forwardmx.net/api/forwarders/update/

Update a forwarder entry on your domain

key required Your API Key (Login and see your account page)
domain required A domain on which you want to edit the alias
user required @ for catch all, or any username without @domain you want to change
destination required A email address the messages should be forwarded to
{"ok": "$Message"}
{"error": "$Message"}
GET/POST https://forwardmx.net/api/forwarders/destroy/

Destroy a alias from your account/domain

key required Your API Key (Login and see your account page)
domain required A domain on which you want to edit the alias
user required Alias source you want to remove
{"ok": "$Message"}
{"error": "$Message"}

Writing and deleting operations all return either as hash with ok: message, or error: message.

{"ok": "$Message"}
{"error": "$Message"}


Was this answer helpful?

« Back