Common Error Codes
Last updated 22 hours ago
HTTP status codes
- 400 Bad Request — Invalid input data. Check the request body matches the expected format.
- 401 Unauthorized — Missing or invalid authentication. Include a valid API key or be logged in.
- 403 Forbidden — You don't have permission. Possible causes: wrong role, product not enabled, not on Pro plan.
- 404 Not Found — The resource doesn't exist or belongs to a different tenant.
- 409 Conflict — Duplicate resource or a concurrent operation is in progress (e.g., an open checkout session).
- 429 Too Many Requests — Rate limit exceeded. Wait 1 minute and retry.
- 500 Internal Server Error — Something went wrong on our end. If this persists, contact support.
MCP-specific errors
- "Unknown method": The tool name doesn't exist. Check the tool name spelling.
- "Parse error": The JSON-RPC request is malformed.
- Tool returns
isError: true: The API call succeeded but the operation failed. Check the error message for details.
