Skip to content

Build on STOQ

APIs, SDK, storefront JavaScript and MCP for building on STOQ preorders and back in stock alerts.

What are you building?

  1. Get an API key

    In the STOQ app, open Back in stock alerts > Settings > Integrations, press Set up on the API card under Developer and copy the key (step by step). Send it on every request in the X-Auth-Token header.

  2. Make your first request

    curl https://app.stoqapp.com/api/v2/external/account/agent_activity \
    -H "X-Auth-Token: $STOQ_API_KEY"
  3. Handle errors and limits

    Failed requests return { "errors": [...] } with a 4xx status. Each store gets 360 points per 60 seconds (a read costs 1, a write 2); on a 429, wait for Retry-After. See Errors and Rate limits.

All changes →

For AI agents and tools: the OpenAPI specs are at /openapi/api-v2.json and /openapi/api-v1.json, and the MCP server reaches every API v2 action.