shopify-common-errors

# Shopify Common Errors ## Overview Quick-reference guide for the most common Shopify API errors with real error messages, causes, and fixes. ## Prerequisites - Shopify app with API credentials configured - Access to application logs or console output ## Instructions ### Step 1: Identify the Error Type Check whether the error is an HTTP status code error or a GraphQL `userErrors` response. ### Step 2: Match Error Below and Apply Fix --- ### 401 Unauthorized **Actual Shopify Response:** ```json { "errors": "[API] Invalid API key or access token (unrecognized login or wrong password)" } ``` **Causes:** - Access token expired (merchant uninstalled and reinstalled) - Wrong `X-Shopify-Access-Token` header - Using a Storefront API token for Admin API or vice versa **Fix:** ```bash # Verify token format: # Admin API token: shpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (32 hex chars) # Storefront API token: different format, starts with shpat_ too curl -s -o /dev/null -w "%{http_code}" \ -H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" \ "https://your-store.myshopify.com/admin/api/2024-10/shop.json" # Should return 200 ``` --- ### 403 Forbidden **Actual Shopify Response:** ```json { "errors": "This action requires merchant approval for read_orders scope." } ``` **Cause:** Your app's access token lacks the required scope. **Fix:** Add the needed scope to your app config and re-trigger OAuth: ```toml # shopify.app.toml [access_scopes] scopes = "read_products,write_...