Create competition
wom_create_competitionCreate a new competition by specifying title, metric, start and end times. Optionally add participants, define teams, or link to a group to include its members. Returns a verification code required for future modifications.
Instructions
Creates a new competition. Returns the created competition plus a verification code - store this code, it's required for all future edits/deletes and cannot be recovered. Either provide participants for a classic competition, or teams for a team competition (not both), or link it to a group via groupId/groupVerificationCode to include all group members.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| teams | No | Teams for a team competition. | |
| title | Yes | ||
| endsAt | Yes | ISO 8601 datetime for when the competition ends. | |
| metric | Yes | A metric name. One of: a skill (overall, attack, defence, strength, hitpoints, ranged, prayer, magic, cooking, woodcutting, fletching, fishing, firemaking, crafting, smithing, mining, herblore, agility, thieving, slayer, farming, runecrafting, hunter, construction, sailing), a boss (abyssal_sire, alchemical_hydra, amoxliatl, araxxor, artio, barrows_chests, brutus, bryophyta, callisto, calvarion, cerberus, chambers_of_xeric, chambers_of_xeric_challenge_mode, chaos_elemental, chaos_fanatic, commander_zilyana, corporeal_beast, crazy_archaeologist, dagannoth_prime, dagannoth_rex, dagannoth_supreme, deranged_archaeologist, doom_of_mokhaiotl, duke_sucellus, general_graardor, giant_mole, grotesque_guardians, hespori, kalphite_queen, king_black_dragon, kraken, kreearra, kril_tsutsaroth, lunar_chests, maggot_king, mimic, nex, nightmare, phosanis_nightmare, obor, phantom_muspah, sarachnis, scorpia, scurrius, shellbane_gryphon, skotizo, sol_heredit, spindel, tempoross, the_gauntlet, the_corrupted_gauntlet, the_hueycoatl, the_leviathan, the_royal_titans, the_whisperer, theatre_of_blood, theatre_of_blood_hard_mode, thermonuclear_smoke_devil, tombs_of_amascut, tombs_of_amascut_expert, tzkal_zuk, tztok_jad, vardorvis, venenatis, vetion, vorkath, wintertodt, yama, zalcano, zulrah), an activity (bounty_hunter_hunter, bounty_hunter_rogue, clue_scrolls_all, clue_scrolls_beginner, clue_scrolls_easy, clue_scrolls_medium, clue_scrolls_hard, clue_scrolls_elite, clue_scrolls_master, last_man_standing, pvp_arena, soul_wars_zeal, guardians_of_the_rift, colosseum_glory, collections_logged), or a computed metric (ehp, ehb). | |
| groupId | No | Attach this competition to a group. | |
| startsAt | Yes | ISO 8601 datetime for when the competition starts. | |
| participants | No | Usernames for a classic (non-team) competition. | |
| groupVerificationCode | No | Required if groupId is set. |