--- a/mod_auth_oauth_external/README.md	Sat Jan 17 08:11:50 2026 +0100
+++ b/mod_auth_oauth_external/README.md	Sat Jan 17 08:12:14 2026 +0100
@@ -37,6 +37,19 @@
 oauth_external_username_field = "xmpp_username"
 ```
 
+### Mastodon Example
+
+```lua
+VirtualHost "example.net"
+authentication = "oauth_external"
+
+oauth_external_token_endpoint = "https://mastodon.example/oauth/token"
+oauth_external_validation_endpoint = "https://mastodon.example/api/v1/accounts/verify_credentials"
+oauth_external_username_field = "username"
+oauth_external_scope = "read:accounts"
+oauth_external_resource_owner_password = true
+```
+
 
 ## Common