Webhooks
Listen for new events created by Yorlet a trigger actions.
Webhooks allow you to react to events in real-time instead of polling our API for updates. The webhook endpoint is a URL that can accept a POST request with the event data in JSON format.
Events
Securing your endpoint
Once your server is configured to receive payloads, it'll listen for any payloads sent to the endpoint you configured. Each webhook endpoint you create will get a secret token Yorlet will use to sign the events. For security reasons, you probably want to verify that the payloads are coming from Yorlet.
Example of a server verifying webhook payload
Node
1
// This example uses Express to receive webhooks
2
const express = require('express');
3
var crypto = require('crypto')
4
5
const app = express();
6
app.use(require('body-parser').raw({ type: '*/*' }));
7
8
app.post('/yorlet-webhook', (req, res) => {
9
10
const signature = request.header('X-Yorlet-Signature')
11
const hmac = crypto.createHmac('sha256', '{{WEBHOOK_SECRET}}')
12
hmac.update(req.body.toString())
13
14
if(hmac.digest('base64') !== signature) {
15
return res.status(401).send("Signatures didn't match")
16
}
17
18
/* Get the JSON data */
19
const event = JSON.parse(req.body.toString());
20
21
return res.status(200).send({received: true});
22
});
23
24
app.listen(8000);
Copied!
Last modified 11mo ago
Copy link