Introducing Webhooks for LiquidPlanner

Liz Rosen | January 31, 2013

left Image

Listen up all you Developers out there – we’ve got a little something just for you.  If you’re reading this simply as an LP customer or fan, please run and tell your geek friends (I say that with love, truly I do) to tune in, because we’re hoping they’ll be excited as we are about our latest feature: Webhooks!

Since I’m not a developer, I called in some of my friends to answer questions in a language that made sense to me:

What are Webhooks?

Webhooks are push notifications triggered by events in LiquidPlanner.  For example, an event might be the creation of a new project, updates to existing tasks, comments on those tasks, and more.  The notification consists of code that is posted to a target URL that you specify.  And then you can take that information and do whatever you want with it.

Why use Webhooks?

Why not?!  Okay, because this will make it easy to integrate LiquidPlanner with your external systems. Webhooks are event-driven and push-based, so you don’t need to poll LiquidPlanner, asking “Has anything happened?  Has anything happened?  Has anything happened?”  Sit back and relax, as soon as something happens, we’ll tell you.

What exactly can Webhooks notify you about?

How ‘bout if I just show you the list?

Webhooks interface

You can pick and choose the specific type of record that you want notifications about, or leave the event field set to “all updates” and be notified about everything.

Where does the information get sent?

It gets sent to a target URL.  That can be a script you write or a third-party service like RequestBin. The primary requirements are that the location is publicly accessible using HTTPS (to keep your information secure in transit) and that it accepts POST requests with JSON bodies.

Why are we so excited about Webhooks?

As I said earlier, instead of people making big requests to us, we’ll just tell them when things happen.  No big requests coming in, means all the more available resources and thus even better performance for you. We value the customer experience and if we’re making it better for you, that makes us happy!

For more details such as who can configure Webhooks, how to get started, and even how to do some troubleshooting, please check out the Configuring and using Webhooks article found in the LP Developer Hub.