TS
Tournament Suite
TS
Tournament Suite
Help CenterPlatform OverviewProducts, Roles, and How They Fit TogetherWhat Is Tournament SuiteCreate Your AccountQuick-Start: Your First TournamentCreate a ProjectProject DashboardProject Settings: General and AppearanceManage Team and RolesCircuits and SeasonsCreate a TournamentTournament Settings OverviewRegistration SettingsParticipant and Match RulesSet up tournament structure and formatsSeed and place participantsSchedule matchesPublish and Go LiveDuplicate a tournamentUse and manage tournament templatesManage RegistrationsCheck-InCustom FieldsExport ParticipantsMonitor and Control a Live TournamentApply Interventions to a MatchTrack and Resolve Issues During a Live EventHandle Officiating and Formal DisputesSet Up Streams and the Broadcast CenterSet Up Branding and SponsorsReview your project's financial activityConfigure prize pools and disburse winningsSet up your payout methodHold prize funds in escrowManage project communications from the hubCreate and send campaigns to participantsCreate and manage API keysReceive real-time event notifications with webhooksConnect Tournament Suite to a Discord serverManage Tournament Permissions and Staff AccessReview and Resolve Participant AppealsConfigure Wellness Settings for Your ProgramProjects, Workspaces, and Team ManagementTournament Creation, Settings, and StructuresLive Operations, Broadcast, Streams, and MediaGovernance, Support, Integrations, and Organization ControlsPublic Discovery and Viewer Experience

Receive real-time event notifications with webhooks

Webhooks send an HTTP POST to your server whenever a specified event occurs in Tournament Suite.

A webhook is an outbound HTTP callback. When an event you subscribe to occurs — such as a new registration or a match result being recorded — Tournament Suite sends a JSON payload to a URL on your server. This lets your system react to changes in real time without polling the API.

Where to find it

Developer → Webhooks

Step by step

  1. Go to Developer → Webhooks and click Add webhook.
  2. Enter the endpoint URL — the publicly accessible URL on your server that will receive POST requests from Tournament Suite.
  3. Select the events to subscribe to. Common events include:
    • registration.created — a new registration has been submitted
    • registration.accepted — a registration has been accepted
    • match.result — a match result has been recorded
    • tournament.status_changed — a tournament moves to a new state (e.g. published, in progress, completed)
    • Additional events are listed in the event picker when creating the webhook.
  4. Add a signing secret. Tournament Suite will include a signature header in every request so your server can verify the payload came from Tournament Suite and was not tampered with. This step is strongly recommended.
  5. Click Save.

Testing a webhook

After creating the webhook, open Developer → Webhooks → [Webhook] and click Send test payload. Your server should respond with HTTP 200 within a few seconds. Check the Delivery log on the same page to confirm the test succeeded or to review any error response.

Payload format

Each webhook payload is a JSON object containing:

  • event — the event type string (e.g. registration.created)
  • timestamp — ISO 8601 timestamp of when the event occurred
  • The relevant object for that event (e.g. the full registration record, match record, or tournament record)

Before processing a payload, verify the signature header against your signing secret to confirm authenticity. Respond with HTTP 200 to acknowledge receipt. If your server returns a non-200 status or times out, Tournament Suite will log the failure in the delivery log; check the log to diagnose delivery issues.

What happens next

With webhooks in place, your server receives events as they happen. To authenticate outbound API calls from your side, see API Keys. To post tournament updates directly to a Discord server, see Discord Integration.

Create and manage API keys

API keys let external systems access Tournament Suite data programmatically using the REST API.

Connect Tournament Suite to a Discord server

The Discord integration posts tournament updates and match notifications to channels in your Discord server automatically.

On this page

Where to find itStep by stepTesting a webhookPayload formatWhat happens next