+BookStack can now emit webhooks! These are web requests that are emitted by BookStack
+when someone performs an action in the system (Updates page, Creates book etc..).
+Webhooks can be found by an administrator in the application settings.
+
+!! Image of webhooks list
+
+Webhooks can be triggered by any event that's tracked in the audit log. You can choose
+specific events to trigger your webhooks or you can trigger upon any event.
+
+!! Image of webhook create view
+
+When triggered, BookStack will send a HTTP POST JSON request to the provided endpoint
+with a common set of details regarding the event. The general data format is shown when creating
+or editing a webhook, but the below is an example of a "page_update" event:
+
+```json
+{
+ "event": "page_update",
+ "text": "Benny updated page \"My wonderful updated page\"",
+ "triggered_at": "2021-12-11T22:25:10.000000Z",
+ "triggered_by": {
+ "id": 1,
+ "name": "Benny",
+ "slug": "benny"
+ },
+ "triggered_by_profile_url": "https://bookstack.local/user/benny",
+ "webhook_id": 2,
+ "webhook_name": "My page update webhook",
+ "url": "https://bookstack.local/books/my-awesome-book/page/my-wonderful-updated-page",
+ "related_item": {
+ "id": 2432,
+ "book_id": 13,
+ "chapter_id": 554,
+ "name": "My wonderful updated page",
+ "slug": "my-wonderful-updated-page",
+ "priority": 2,
+ "created_at": "2021-12-11T21:53:24.000000Z",
+ "updated_at": "2021-12-11T22:25:10.000000Z",
+ "created_by": 1,
+ "updated_by": 1,
+ "draft": false,
+ "revision_count": 9,
+ "template": false,
+ "owned_by": 1
+ }
+}
+```
+
+Webhooks have a `text` property (Populated where possible, depending on event) which allows them to
+be used directly in slack or slack-compatible services. If you wanted to get more advanced
+you could build your own middleware or use a service like [Zapier](https://zapier.com/) or [n8n](https://n8n.io/)
+to build more advanced event based integrations. For example:
+
+- Email an admin when application settings are changed.
+- Post in slack when a book is deleted.
+- Log page changes to a Google doc.
+- Update a BookStack page via the REST API when new users register.
+
+The possibilities are pretty endless.
+
+Since webhooks need to make external HTTP requests, they have potential to slow down a system.
+If you're introducing webhooks that'd be triggered we have a way to run these in the background to
+prevent user experience slowdowns. Details about this can be found in the docs here.
+
+!! TODO - Update above with link
projects / website / commitdiff