inertia
DashboardTournamentsDocumentation
Documentation
  • Docs
  • Structure
  • Integrations
  • Matches
  • Races
  • Videos
  • Metafields
  • Events
  • API

Events

Inertia is an event-based system and has several events you can listen for to customize the tournament experience and build unique integrations for your tournament. These events are served as Webhooks provided by Svix.

Verifying Webhooks

It is important to verify a webhook before processing it. This ensures that the webhook was sent by Inertia and not a malicious third party. To verify a webhook event, please refer to Svix's documentation on how to verify webhooks and have your Inertia API credentials ready.

Event Catalog

Event NameDescriptionPayload
race.scheduledWhen a race in a match becomes scheduled.
{
  "event": "race.scheduled",
  "match_id": "heltxf9gegi8",
  "race_id": "heltxf9gegi8"
}
race.setting_upThis is the URL for the Racetime room.
{
  "event": "race.setting_up",
  "match_id": "heltxf9gegi8",
  "race_id": "heltxf9gegi8",
  "racetime_url": "https://racetime.gg/smr/comic-yappingmaw-6531"
}
race.startedThe race has begun.
{
  "event": "race.started",
  "url": "https://racetime.gg/smr/comic-yappingmaw-6531"
}
race.endedThe race has ended.
{
  "event": "race.ended",
  "url": "https://racetime.gg/smr/comic-yappingmaw-6531"
}
tournament.user.joinThis is the URL where the runners will get the specific randomized seed for their race.
{
  "event": "tournament.user.join",
  "tournament_id": "a49tqi2d0qur",
  "user_id": "514gpsscur43"
}