Gamearly API v1
Dashboard

Quests / In-game rewards

In-game rewards and events#

Use Gamearly quests to drive live game logic: grant items or currency, unlock areas, open doors, spawn events. You can rely on any quest type — including social quests like Join Discord, Wishlist on Steam, Follow on X — and react in real time inside your game.

Requirements#

  • The player must be linked to Gamearly — see Gamearly Connect.
  • Your project should either receive the quest.completed webhook and react, or poll our check endpoints to verify completion on demand.

Two ways to detect completion#

  1. Webhook — set up a webhook endpoint to receive the quest.completed event. This is the most efficient way to react in real time.
  2. Polling or manual checking — periodically check quest status, or check when a player asks to verify. Use this if the player linked their account after completing the quest. The endpoints are /quests/check_quest_completed for a whole quest and /quests/check_task_completed for an individual task.

Finding a quest id

The quest id is in the URL of the quest on Gamearly — e.g. https://app.gamearly.com/quests/27 — or from the /quests/list endpoint.