New Programmatic Webhooks - Nylas

New Programmatic Webhooks

New programmatic webhooks ensure you get updates in real-time while automatically reconnecting if your servers experience down-time.

Tasia Potasinski | August 19, 2019

Staying up to date with the latest email, calendar and contacts data just became easier today. Now, you can automatically detect if your webhook is down, and auto re-enable the webhook in seconds without ever logging in to the Nylas dashboard.

We’ve added support for PUT , POST, and DELETE on our webhooks endpoints, allowing you to create, delete, enable, or disable webhooks programmatically:

  • POST a new webhook using code, rather than manually creating them by hand in the Nylas dashboard
  • Update an existing webhooks state to “active” or “inactive”
  • DELETE webhooks through the Nylas API, rather than having to visit the Dashboard to do so

This is particularly helpful in cases where your servers experience extended downtime, causing your webhook to de-activate. Now, you can now programmatically detect and re-enable the webhook without your customers even noticing a disruption.

Let’s take a look at some examples; the first shows how to create a webhook that is triggered whenever a message is opened.

curl -X POST \{client_id}/webhooks/ \ 
  -H 'Authorization: Basic mYSuP3rSecR3tB4s1cAutHtOk3n=' \ 
  -H 'Content-Type: application/json' \ 
  -d '{
    "callback_url": "",
    "triggers": ["message.opened"],
    "state": "active" 

The next example shows how to update the status of a webhook.

curl -X PUT \{client_id}/webhooks/{id} \
  -H 'Authorization: Basic mYSuP3rSecR3tB4s1cAutHtOk3n=' \
  -H 'Content-Type: application/json' \ 
  -d '{
    "state": "inactive" 

You can find more information about programmatic webhooks in our docs:

Happy building!

About the Author

Tasia is the Head of Marketing at Nylas. In her free time, she enjoys discovering new running trails in the Marin Headlands and exploring the best vegan bakeries in San Francisco.

Ready to Start Building?