# 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>                                                                                                                                                                                                                                                                                                                                                                                                                      |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getmesa.com/connect/shopify/technical-notes/error-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
