⚽ Convocados Docs GitHub

Events

Events are the core of Convocados — each one represents a game session.

Creating an event

From the home page, fill in the create form:

FieldRequiredDescription
titleYesGame name, up to 100 characters
sportNoSport type — defaults to Football 5v5. Changing the sport auto-sets max players to the sport default
dateTimeYesMust be in the future
locationNoText or URL — URLs become clickable links, plain text links to Google Maps
maxPlayersNo2–30, auto-set by sport. Players beyond this go to the bench
teamOneNameNoDefaults to "Ninjas"
teamTwoNameNoDefaults to "Gunas"

Event URL

Each event gets a unique URL like /events/clx1abc2d.... This is the only way to access the event — there's no login or account system. Share this link with your group.

Event lifecycle

  1. Created — event is live, players can join
  2. Players join — via the shared link
  3. Teams randomized — when enough players are in
  4. Game played — at the scheduled date/time
  5. Reset (recurring only) — player list clears, event advances to next date

Recurring events

Enable Recurring game in advanced options to auto-reset the player list. See Recurring Games for details.

Rate limiting

Event creation is rate-limited to 10 events per hour per IP to prevent abuse.