# Error Codes

Here is a list of common Shopify errors and common solutions. If you have any questions, please don't hesitate to contact MESA support.

| 400 Bad Request           | The request was not understood by the server, generally due to bad syntax or because the `Content-Type` header was not correctly set to `application/json`.This status is also returned when the request provides an invalid `code` parameter during the [OAuth](https://shopify.dev/apps/auth/oauth) token exchange process.                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401 Unauthorized          | <p>The necessary <a href="https://shopify.dev/apps/auth">authentication connections</a> are not present in the request or are incorrect.<br><strong>Solution</strong>: <a href="../..#connect">Double-check your connection</a> and replay the automation.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 402 Payment Required      | The requested shop is currently frozen. The shop owner needs to log in to the shop's admin and pay the outstanding balance to unfreeze the shop.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 403 Forbidden             | <p>The server is refusing to respond to the request. This is generally because you have not <a href="https://shopify.dev/apps/auth/oauth#3-ask-for-permission">requested the appropriate scope</a> for this action.<br><strong>Solution</strong>: <a href="../..#connect">Double-check your connection</a> and replay the automation.<br></p>                                                                                                                                                                                                                                                                                                                                                                                      |
| 404 Not Found             | <p>The requested resource was not found but could be available again in the future.<br><strong>Solution</strong>: Verify that the ID you are passing is correct and exists.<br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 406 Not Acceptable        | The requested resource is only capable of generating content not acceptable according to the Accept headers sent in the request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 422 Un-processable Entity | <p>The request body was well-formed but contains semantic errors. A <code>422</code> error code can be returned from a variety of scenarios including, but not limited to:<br><br></p><ul><li>Incorrectly formatted input</li><li>Checking out products that are out of stock</li><li>Canceling an order that has fulfillments</li><li>Creating an order with tax lines on both line items and the order</li><li>Creating a customer without an email or name</li><li>Creating a product without a title</li></ul><p>The response body provides details in the <code>errors</code> or <code>error</code> parameters.<br><br><strong>Solution</strong>: Check that your configuration is correct and replay the automation.<br></p> |
| 423 Locked                | The requested shop is currently locked. Shops are locked if they repeatedly exceed their API request limit, or if there is an issue with the account, such as a detected compromise or fraud risk. [Contact Shopify support](https://help.shopify.com/en/questions#/contact) if your shop is locked.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 429 Too Many Requests     | <p>The request was not accepted because the application has exceeded the rate limit. Learn more about <a href="https://shopify.dev/api/usage/rate-limits">Shopify’s API rate limits</a>.<br><strong>Solution</strong>: <a href="../..#connect">Try using a Shopify Custom App MESA connection</a> or replay the automation when there is less activity on your store.</p>                                                                                                                                                                                                                                                                                                                                                          |
| 500 Internal Server Error | <p>An internal error occurred in Shopify. Please post in the <a href="https://community.shopify.com/c/Shopify-APIs-SDKs/bd-p/shopify-apis-and-technology">Shopify APIs and SDKs forum</a> so that Shopify staff can investigate.<br><strong>Solution</strong>: Please replay your automation or contact Shopify for their staff to investigate.<br></p>                                                                                                                                                                                                                                                                                                                                                                            |
| 501 Not Implemented       | <p>The requested endpoint is not available on that particular shop, e.g. requesting access to a Shopify Plus–only API on a non-Plus shop. This response may also indicate that this endpoint is reserved for future use.<br><strong>Solution</strong>: <a href="../..#connect">Try using a Shopify Custom App MESA connection that has access to Plus-only APIs.</a><br></p>                                                                                                                                                                                                                                                                                                                                                       |
| 503 Service Unavailable   | <p>The server is currently unavailable. Check the <a href="https://www.shopifystatus.com/">Shopify status page</a> for reported service outages.<br><strong>Solution</strong>: Replay this automation.<br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 504 Gateway Timeout       | <p>The request could not complete in time. Shopify waits up to 10 seconds for a response. Try breaking it down in multiple smaller requests.<br><strong>Solution</strong>: Try restructuring your MESA workflow to break it down into smaller parts. Reach out to MESA support if you have any questions.</p>                                                                                                                                                                                                                                                                                                                                                                                                                      |
