fof / webhooks
Automatically notify Discord, Slack, and Microsoft Teams when events happen on your Flarum forum.
Fund package maintenance!
Opencollective
dsevillamartin
Installs: 17 662
Dependents: 1
Suggesters: 0
Security: 0
Stars: 24
Watchers: 3
Forks: 12
Open Issues: 10
Type:flarum-extension
pkg:composer/fof/webhooks
Requires
- charescape/serialize-closure: ^3.8
- flarum/core: ^2.0.0
- guzzlehttp/guzzle: 7.*
- html2text/html2text: ^4.3.1
- ssnepenthe/color-utils: ^0.4.2
Requires (Dev)
- flarum/approval: *
- flarum/phpstan: ^2.0.0-beta
- flarum/tags: *
Replaces
- dev-master
- 2.x-dev
- 2.0.0-beta.1
- 1.x-dev
- 1.3.3
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.3
- 1.2.2
- 1.2.1
- 1.2.0
- 1.1.5
- 1.1.4
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- 0.5.1
- 0.5.0
- 0.4.1
- 0.4.0
- 0.3.2
- 0.3.1
- 0.3.0
- 0.2.3
- 0.2.2
- 0.2.1
- 0.2.0
- 0.1.7
- 0.1.6
- 0.1.5
- 0.1.4
- 0.1.3
- 0.1.2
- v0.1.1
- v0.1.0
- dev-ds/33-select-multiple-tags
- dev-ds/beta15
This package is auto-updated.
Last update: 2026-01-14 22:28:40 UTC
README
A Flarum extension that allows you to integrate Flarum with external services via webhooks. Automatically notify Discord, Slack, and Microsoft Teams when events happen on your forum.
Installation
Install manually with composer:
composer require fof/webhooks
Updating
composer update fof/webhooks
Usage
Add a Webhook
- Navigate to the extension settings via the side menu item "Webhooks".
- Select the service you are connecting to (e.g., Discord, Slack, Microsoft Teams).
- Paste the Webhook URL provided by that service.
- Click the + button to create a new webhook.
- Choose the events you want to trigger this webhook (e.g., Discussion Started, Post Created, User Registered).
Getting Webhook URLs
Discord
- Go to a Discord channel settings.
- Select Integrations -> Webhooks.
- Click New Webhook.
- Customize the name (can be overridden by extension settings).
- Copy the generated Webhook URL.
Slack
Refer to the official Slack documentation for more info: https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks/
- Create a Slack app (if you don't have one) here: https://api.slack.com/apps
- Activate Incoming Webhooks for your app in its settings page.
- Click Add New Webhook to Workspace.
- Select the channel to post to and authorize.
- Copy the generated Webhook URL.
Microsoft Teams
Refer to official Microsoft Teams documentation for more info: https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498. Note that the old method (Microsoft/Office 365 Connectors) still work as of January 2026, but are deprecated.
- Navigate to the channel where you want to add the webhook.
- Click the
...(More options) next to the channel name. - Select Connectors.
- Search for Incoming Webhook and click Configure.
- Give it a name and click Create.
- Copy the URL displayed at the bottom of the window.
Links
An extension by FriendsOfFlarum.