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

Create and manage API keys

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

An API key is a credential that authenticates requests from your server or integration to the Tournament Suite API. Each key carries a defined set of permissions (scopes) that control what the key can read or modify. Keys are not tied to a user account, so they continue to work even if team members change.

Where to find it

Developer → API Keys

Step by step

  1. Go to Developer → API Keys and click Create API key.
  2. Enter a descriptive name for the key so you can identify its purpose later — for example, Production integration or Data sync script.
  3. Select the scopes the key should have. Grant only the permissions the integration actually needs:
    • Read-only scopes for data retrieval
    • Write scopes for creating or updating resources
    • Specific resource scopes (e.g. tournaments, registrations, matches) to limit access
  4. Click Create.
  5. Copy the generated key immediately. The full key value is shown only once. If you close the page without copying it, you will need to revoke the key and create a new one.
  6. Store the key in a secrets manager or environment variable. Do not commit it to source code or share it in plain text.

Managing existing keys

  • The API Keys list shows all active keys, their assigned scopes, and the last time each key was used.
  • To remove a key, click Revoke. Revocation is immediate and permanent — any integration using that key will lose access.
  • If a key may have been exposed, revoke it straight away and create a replacement.

Testing your integration

Use the API Reference (Developer → API Reference) to browse available endpoints and understand request and response formats. Use the Sandbox (Developer → Sandbox) to run test calls against a non-production environment before going live.

Note: API access may be gated by your project plan. If you do not see the Developer section or cannot create keys, check your plan at Projects → [Project] → Settings → Billing.

What happens next

With a key in hand, you can authenticate API requests and start building your integration. If you need your server to receive real-time event notifications rather than poll the API, set up a Webhook. To connect Tournament Suite to a Discord server, see Discord Integration.

Create and send campaigns to participants

Campaigns are messages sent to a defined audience of participants, either immediately or on a schedule.

Receive real-time event notifications with webhooks

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

On this page

Where to find itStep by stepManaging existing keysTesting your integrationWhat happens next