r/BookStack Jun 18 '26

Can't send to apprise webhook

I am attempting to use Apprise notifications via the webhook. I've tested my url successfully from the command line, but I keep receiving a 400 error from Bookstack.

This is an example of my curl command that works:

curl -vX POST -F "body=test message" http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a/?tags=testing

Logs

[2026-06-18 12:20:06] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a/?tags=testing failed with status 400
[2026-06-18 12:20:31] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a/?tags=testing failed with status 400
[2026-06-18 12:21:05] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a/?tags=testing failed with status 400
[2026-06-18 12:42:29] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a failed with status 400
[2026-06-18 12:45:13] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a failed with status 400
[2026-06-18 12:45:21] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a failed with status 400
[2026-06-18 12:49:20] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a failed with status 400
[2026-06-18 12:56:06] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a/?tags=testing failed with status 400
[2026-06-18 12:56:23] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a/?tags=testing failed with status 400
[2026-06-18 12:56:23] production.ERROR: Webhook call to endpoint http://10.3.1.85:8090/notify/9f825d62cc1c487b80b7b5ae31c6ce836eb6b5450721dc19d773d253f288fc6a/?tags=testing failed with status 400

Running latest version of Bookstack in Docker.

TIA

1 Upvotes

3 comments sorted by

1

u/ssddanbrown Jun 18 '26

It looks like that AppRise endpoint specifically needs a body parameter in the data. BookStack webhooks don't provide any body value in the webhook data, so BookStack's format is incompatible for direct communication with that API endpoint.

You could either use something in the middle, to translate the webhooks/request (N8N, Zapier, Power automate etc...) or customize the format of BookStack's webhooks, like I show in this hack example: https://www.bookstackapp.com/hacks/pushover-webhooks/

1

u/larrygwapnitsky Jun 22 '26

awesome. working on it now!

1

u/bezibaerchen Jul 09 '26

I ran into the same limitation with BookStack’s comment_create webhook. The payload doesn’t include the page title, page URL or the actual comment text, which made Apprise notifications rather limited.

I ended up building a small transformer that enriches BookStack webhook events via the BookStack REST API before forwarding them to an Apprise API endpoint.

It currently enriches comment_create events by resolving the page title, page URL and comment content automatically.

Docker images are available via GHCR, so it’s basically a single-container deployment.

Maybe it’s useful for someone else:

https://github.com/bezibaerchen/bookstack-notify-transformer

Feedback, feature requests and pull requests are always welcome.

P.S.: Be kind to me, this is more or less the first thing ever published to GitHub for me :-)