Skip to content

Webhook Setup Guide

Katalyst delivers webhooks at the trading-group level — there is no separate per-account webhook and no Settings → Integrations tab. Group owners and managers can send real-time notifications to Slack, Discord, or any custom endpoint whenever activity happens in the group.

To create one, open your group and go to its Webhooks page (owners and managers only), click “New Webhook,” give it a name, and paste the destination URL. Then choose which events should trigger it: Post Created, Post Deleted, Member Joined, Member Left, Trade Shared, Event Created, and Offer Created. A single webhook can subscribe to several events, or you can create separate webhooks for different destinations.

Katalyst formats the payload automatically based on the destination. Paste a Slack incoming-webhook URL (hooks.slack.com) or a Discord webhook URL (discord.com/api/webhooks) and Katalyst posts a ready-to-read message in that platform’s native format — no secret required.

For a custom (non-Slack/Discord) endpoint, Katalyst sends a structured JSON payload — {event, groupId, data, sentAt} — signed with an HMAC-SHA256 signature in the X-Katalyst-Signature header, using a secret shown once when you create the webhook so you can verify authenticity. The endpoint must accept HTTP POST and respond with a 2xx status.

Deliveries are retried automatically on failure, and a webhook that fails repeatedly is paused so it can be reviewed. See “Slack Integration” and “Discord Integration” for step-by-step setup.