What a webhook is
A webhook is a message Datamolino sends to another application when a specific event happens. For example, Datamolino can call another application when documents become ready for export.
To receive webhooks, you tell Datamolino where to send them by entering the URL of the receiving application or service.
When to use webhooks
You want to process results from Datamolino in an integration platform such as Zapier, for notifications, reporting or import into other systems.
Your own application can accept and process the Datamolino webhook payload.
You use the Datamolino API. Webhooks are the only supported way to be notified when documents are ready. The old polling flow, where your application kept checking for results, has been retired and should not be used.
How to set up a webhook
Only account Owners and Managers can create webhooks.
Open Account Management and go to the Webhooks section.
Click Create Webhook.
Fill in the Endpoint URL - the address Datamolino will send the data to.
Optionally add Basic Auth credentials (a user name and password) to secure the webhook.
Each webhook consists of metadata and the document payload. The metadata describes the event type, for example extraction finished or extraction failed. The payload contains the document data.
Send a webhook manually
You can also trigger a webhook callback for a document by hand, from the document detail or from the document list.
For technical details of the payload format, see developer.datamolino.com.