Send notifications to a custom webhook

Pool creators can send Trofeo.live events to their own system by adding a webhook URL in the pool's notification settings. This is the generic option to use when your target isn't Slack, Discord, Microsoft Teams, or Telegram.

Setup

Prerequisites

• You need edit access to the pool (owner or a workspace member with edit permission).
• Your endpoint must be reachable over HTTPS at a public hostname. URLs pointing at localhost, .local, or .internal hosts are rejected.

To connect a webhook:

1. Open the pool and go to the Integrations tab.
2. Find the Webhook card and turn it on.
3. Paste your endpoint's HTTPS URL into the Webhook URL field.
4. Save your changes.

Trofeo.live checks that the URL is a valid public HTTPS address before it will accept it. If the URL fails that check, you'll see an error asking you to enter a valid public HTTPS webhook URL, and the integration won't be marked as connected until it passes.

Testing

To confirm your endpoint is reachable, use the send-test action on the Webhook card. This fires a single sample event to the URL you entered (or to the saved URL if you leave the field as-is) so you can see it land before real pool events start flowing.

The test payload looks like this:

{
  "event": "test",
  "poolId": "<your pool id>",
  "poolName": "<your pool name>",
  "headline": "Test from Trofeo.live",
  "detail": "Your webhook integration is wired up.",
  "url": "https://trofeo.live/p/<pool slug>"
}

If the request succeeds, the test reports success and you can treat the integration as connected. If it fails, for example your endpoint times out, returns a non-2xx status, or the URL doesn't pass the HTTPS/public-host check, you'll get an error describing why the send failed. Fix the URL or your endpoint and send another test until it comes back clean.

Once the test passes, your webhook will receive the same kind of event payload whenever the pool triggers a notification, so your own system can react to pool activity without needing to poll Trofeo.live.