Wheel embeds, URL params, result events, and API

Iframe URLs

https://www.wheelofgiveaways.com/wheelofgiveaways?listName=summer-draw

https://www.wheelofgiveaways.com/customwheel?listName=creator-picks

https://www.wheelofgiveaways.com/crimsonwheel?wheel_type=member

https://www.wheelofgiveaways.com/pcgiveaway?chromeless=true&wheel_type=tier

Wheel pages are hosted at the root of www.wheelofgiveaways.com. Embedding domains should include parentOrigin with their exact origin.

URL Params

Getting Results From The Iframe

Listen for TCM_WHEEL_SPIN_COMPLETE. Validate event.origin against the wheel origin before trusting the payload.

window.addEventListener("message", (event) => {
  if (event.origin !== "https://www.thecrimsonmarket.com") return;
  if (event.data?.type !== "TCM_WHEEL_SPIN_COMPLETE") return;

  const { result, context } = event.data;
  console.log(result.winner, context.listName, context.drawSlug);
});

The wheel posts height updates with IFRAME_HEIGHTand URL-sync requests with UPDATE_URL_BAR_ONLY. Cross-domain hosts must pass parentOrigin=https://their-origin.exampleso the wheel can target the parent safely.

Hosted pages can pass data_source=parent and send TCM_WHEEL_MEMBER_SEGMENTS_SYNC or TCM_WHEEL_PC_CONFIG_SYNC to keep the iframe on the same data snapshot as the parent page.

Public API

Create a service client in the Developers portal, request audience service.wheel, and grant the needed scopes: wheel:read, wheel:write, and wheel:spin.

curl -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials \
  -d resource=service.wheel \
  -d scope="wheel:read wheel:write wheel:spin" \
  https://www.thecrimsonmarket.com/mana/oauth/token

Complete settings contract

Send these fields inside settings or branding. Colors use six-digit hex values; unknown fields are ignored.

curl -X PUT https://www.wheelofgiveaways.com/api/v1/wheels/demo/entries \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "entries": [
      { "name": "Alice", "weight": 1, "color": "#E11D48" },
      { "name": "Bob", "weight": 2, "color": "#2563EB" }
    ],
    "prizes": [
      { "name": "Grand Prize", "weight": 1, "color": "#22C55E" },
      { "name": "Runner-up Prize", "weight": 2, "color": "#F59E0B" }
    ],
    "settings": {
      "spinDurationSeconds": 30,
      "colorPalette": ["#B60100", "#111111", "#E7E7E7"],
      "pageBackgroundColor": "#F7F7F8",
      "panelBackgroundColor": "#FFFFFF",
      "primaryTextColor": "#111827",
      "secondaryTextColor": "#4B5563",
      "borderColor": "#CBD5E1",
      "inputBackgroundColor": "#FFFFFF",
      "primaryButtonColor": "#B60100",
      "buttonTextColor": "#FFFFFF",
      "wheelFontSize": 48,
      "outerRimColor": "#B60100",
      "pointerColor": "#111827",
      "pointerStrokeColor": "#B60100",
      "centerHubColor": "#202020",
      "prizesEnabled": true,
      "stageOrder": "entrant-first",
      "panelOrder": ["wheel", "entries", "branding", "currentEntries", "jail", "code"],
      "hiddenPanels": ["code"]
    }
  }'