Skip to content
We Playtest Games

Quickstart: Game Owner

This guide walks you through the complete game owner workflow using the API: register, add a game, order a playtest, and review a submission.

Prerequisites

Section titled “Prerequisites”

You need an API key with the game_owner and billing scopes. See Authentication to create one.

Walkthrough

Section titled “Walkthrough”

  1. Register and get an API key

    Terminal window
    curl -X POST https://app.weplaytestgames.com/api/v1/auth/register/api-key \
      -H "Content-Type: application/json" \
      -d '{
        "email": "dev@mystudio.com",
        "password": "securepassword123",
        "role": "game_owner",
        "name": "My Studio"
      }'

    Save the apiKey from the response. Verify your email before proceeding.

  2. Create your game

    Terminal window
    curl -X POST https://app.weplaytestgames.com/api/v1/games \
      -H "Authorization: Bearer wpg_sk_..." \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Dungeon Crawlers",
        "description": "A roguelike dungeon crawler with pixel art",
        "buildUrl": "https://store.steampowered.com/app/123456",
        "tags": ["roguelike", "pixel-art"]
      }'

    Note the id from the response (e.g., game_abc123).

  3. Add credit to your account

    Terminal window
    curl -X POST https://app.weplaytestgames.com/api/v1/billing/credit \
      -H "Authorization: Bearer wpg_sk_..." \
      -H "Content-Type: application/json" \
      -d '{"amountCents": 10000}'

    Open the checkoutUrl to complete the Stripe payment.

  4. Order a playtest

    Terminal window
    curl -X POST https://app.weplaytestgames.com/api/v1/games/game_abc123/playtests \
      -H "Authorization: Bearer wpg_sk_..." \
      -H "Content-Type: application/json" \
      -d '{
        "visibility": "private",
        "quantity": 3,
        "instructions": "Focus on the tutorial and first boss fight"
      }'

    This creates 3 playtest slots at $20 each ($60 total deducted from credit).

  5. Wait for submissions

    Set up a webhook for slot.submitted events, or poll:

    Terminal window
    curl -H "Authorization: Bearer wpg_sk_..." \
      "https://app.weplaytestgames.com/api/v1/submissions"

  6. Review a submission

    Download the video, then accept or reject:

    Terminal window
    # Get the video download URL
    curl -H "Authorization: Bearer wpg_sk_..." \
      "https://app.weplaytestgames.com/api/v1/slots/slot_abc/download-url"
    

    # Accept the submission
    curl -X POST https://app.weplaytestgames.com/api/v1/slots/slot_abc/accept \
      -H "Authorization: Bearer wpg_sk_..." \
      -H "Content-Type: application/json" \
      -d '{"rating": 5}'

What’s Next

Section titled “What’s Next”