inertia
DashboardTournamentsDocumentation
  • 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 Name Description Payload
race.scheduled When a race in a match becomes scheduled.
{
  "event": "race.scheduled",
  "match_id": "heltxf9gegi8",
  "race_id": "heltxf9gegi8"
}
race.setting_up This 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.started The race has begun.
{
  "event": "race.started",
  "url": "https://racetime.gg/smr/comic-yappingmaw-6531"
}
race.ended The race has ended.
{
  "event": "race.ended",
  "url": "https://racetime.gg/smr/comic-yappingmaw-6531"
}
tournament.user.join This 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"
}