Weekly product update: Manage your webhooks programatically with new API
We usually publish a weekly update on Friday, but this week, we didn't want to wait till then to tell you what you can start doing with Mailgun today. We've just released our new beta webhook API so that you can programatically manage webhooks for all your domains! Our new webhook API, now in private beta, comes on the heals of two other much requested webhooks features: domain-level webhooks and easy testing of webhook endpoints. Read on for the details, and email us at firstname.lastname@example.org if you'd like to gain access to try it out.
Managing your webhooks via API
The new Webhooks API is available for the following events and allows you to perform the following operations.
[onehalf][styledbox title="Available events" color="grey"]<ul> <li>deliver</li> <li>bounce</li> <li>drop</li> <li>spam</li> <li>unsubscribe</li> <li>click</li> <li>open</li> </ul>[/styledbox][/onehalf] [onehalflast][styled_box title="Available operations" color="grey"]<ul>
<li>List webhooks for an account</li>
<li>Return detail for a single webhook</li>
<li>Create new webhook</li> <li>Update existing webhook</li> <li>Delete existing webhook</li> </ul>[/styledbox][/onehalf_last]
What you can do with this new API
The new webhooks API was created to extend the functionality that we introduced a couple weeks ago with the new Domains API, also in private Beta. Together, these new APIs let you set up and manage large scale applications that let your own end customers send completely whitelabled emails via your platform. For instance, let's say you have a new CRM app that lets your customers email their sales prospects. With our new Domains and Webhooks API, you can:
- Create a new domain for each customer (e.g. email.example1, email.example2.com, etc)
- Retrieve DNS records in order to send properly authenticated emails
- Retrieve SMTP credentials for each domain
- Set up webhooks endpoints to track email activity for reporting
You can use either SMTP or the HTTP API to send emails. For tracking we offer both push (webhooks) and pull (APIs) methods to access the data. If you would like us to post the data to your URL as it happens, here are some specific examples of additional things that you can do when webhooks are enabled:
We hope you enjoy using our new Beta APIs. Email us at email@example.com if you'd like access and please, let us know what you think.