IN BETA: Webhook **Custom** Payload Templates

DexterLaBora
Meraki Employee

IN BETA: Webhook **Custom** Payload Templates

The new Webhook Payload Templates feature is awesome!

 

But..

 

     Can I change the formatting a little?

     Does this work with my favorite messaging service?

     Do you support custom authentication headers? 

 

 

 

Instead of Meraki making these decisions and building one-off integrations, why not let the user take control?!

 

Now in Beta, you can create custom payload templates for webhooks to fit the JSON shape, markdown preference and authentication headers that fit your needs.

 

Custom Payload Templates - Documentation

 

Check out the Template Examples section to explore integrations and ideas for your next solution.

 

DexterLaBora_1-1633606063751.png

 

 

Also available in our GitHub repository 

webhook-payload-templates 

 

 

DexterLaBora_4-1633606745352.png

 

 

 

Use the Dashboard API to upload and edit your payload templates.

 

DexterLaBora_5-1633607656283.png

 

Postman Collection for just webhooks management

 

 

Assign payload templates using either the Dashboard or the API

 

DexterLaBora_6-1633607730404.png

 

 

What does a template look like?

A template is written in Liquid, which uses a familiar{{variable}} syntax for those of you who use Postman. The templates will be used to generate the webhook, where the variables and any special liquid syntax will be rendered. This gives you total control as to how you shape the JSON message.

 

Template - body.liquid

DexterLaBora_7-1633607988066.png

 

Result

DexterLaBora_8-1633608010248.png

 

 

Beta participants have access to this endpoint today, and we're excited to hear your feedback. 

How do I join the beta?

If you'd like the join the beta, you can get started here.

 

When will these features be generally available?

The GA date is TBD but we look forward to sharing more information as we collect beta feedback.

3 REPLIES 3
PhilipDAth
Kind of a big deal

Re: IN BETA: Webhook **Custom** Payload Templates

That is super powerfull.

PhilipDAth
Kind of a big deal

Re: IN BETA: Webhook **Custom** Payload Templates

The templates are network-centric.  They need to be loaded into every network.

 

Wouldn't organisation centric be a better place for them?

 

I just can't imagine a case where you would create a template to say how to lay something out for a specific service (such as "Service X"), and then would want to very that per network.  And even if you did, you could just use unique template names.

 

DexterLaBora
Meraki Employee

Re: IN BETA: Webhook **Custom** Payload Templates

The HTTP Servers are network-scoped, so the payload templates followed the similar structure. That being said, we are looking at options for org-wide management but it may take some time. Until then, I would make use of Action Batches if you have to deploy these at scale. 

 

 

Get notified when there are additional replies to this discussion.
Welcome to the Meraki Community!
To start contributing, simply sign in with your Cisco account. If you don't yet have a Cisco account, you can sign up.