Using Team Webhooks for Chart Publish Events

Webhooks are a really useful way to integrate Datawrapper with other services. Datawrapper will notify your team's webhook URL every time a team chart is published. This makes it possible to automatically send messages to your messaging service or trigger other actions like a PNG download of the very chart, which was just published.

To use Team Webhooks, go to your teams settings page and click on the "Integrations" tab. There you can toggle the "Enable custom webhook" switch and enter the URL where your service listens for webhook events.

🚧

Webhooks are only delivered over HTTPS, any other protocol won't work.

Team settings UI with webhook configurationTeam settings UI with webhook configuration

Team settings UI with webhook configuration

Now you are all set up! To try it out, publish a chart that belongs to your team and you will see that your service gets called with a JSON payload that includes the chart ID and version. Since we are sending a request body, our server will make a POST request to your Webhook URL.

POST /webhook HTTP/1.1
content-type: application/json
content-length: 32

{"id":"zPrsY","publicVersion":1}