Build on STOQ
APIs, SDK, storefront JavaScript and MCP for building on STOQ preorders and back in stock alerts.
What are you building?
References
Section titled “References”
API v2 referenceEvery resource and endpoint, with examples
MCP toolsThe tools an agent sees
Error codesWhat each code means and how to fix it
API v1 LegacyThe older REST API
Quickstart (API v2, beta)
Section titled “Quickstart (API v2, beta)”-
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-Tokenheader. -
Make your first request
curl https://app.stoqapp.com/api/v2/external/account/agent_activity \-H "X-Auth-Token: $STOQ_API_KEY" -
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 forRetry-After. See Errors and Rate limits.
Latest changes
Section titled “Latest changes”- API v2: the changelog is available as JSON, with a written stability policy
- API v2 and MCP: back-in-stock counts are named after what they count
- API v2 and MCP: an agent activity log
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.