Audience: Content administrators
To get notifications of publish events for your charts:
- Navigate to the relevant Teams page on the Datawrapper website
- Select "Enable custom webhook"
- If webhooks are enabled, enter the URL provided in the element editing screen of the CMS
- In the CMS ensure 'Auto publish' is checked for relevant Datawrapper content elements
Note: the chart must be in the same Datawrapper Team as the Custom Webhook URL. Move or duplicate the chart to the relevant team if this is not the case. The Datawrapper ID will change if you duplicate the chart.
Audience: Developers
https://developer.datawrapper.de/docs/using-team-webhooks-for-publish-notifications
To test, publish a chart. A sample POST will look like this:
POST /webhook HTTP/1.1
content-type: application/json
content-length: 32
{"id":"abcd1","publicVersion":6, "user":{"id":123,"email":"user@your-org.com"}}
You can use a system such as Pipedream to inspect and debug webhook requests.
Turn off|on via project configuration, the default is true
---
Name: app-datawrapper
After:
- '#nswdpc-datawrapper'
---
NSWDPC\Datawrapper\WebHookController:
webhooks_enabled: true
webhooks_random_code: 'some_random_code_string'Use webhooks_random_code to randomise the URL. Using this example, the submission URL will look something like https://mysite.example.com/_datawrapperwebhook/submit/some_random_code_string/
This is empty by default. It's a good idea to have this value set as anyone who knows the URL and a Datawrapper chart ID you are using will be able to submit webhook requests.
To invalidate webhook requests, change the webhooks_random_code value and flush the configuration. Any webhooks configured at DataWrapper will need to be updated in this event.