Help CenterHelp Center / Developers · Concept
The status codes and messages the APIs and webhooks return, what causes each, and how to fix it.
Send Accept: application/json on every call. Without it, some errors come back as a web page or a redirect.
/api/webhook/...)Messages of one endpoint, such as 409 on customers or 404 on products, are on that endpoint's page. Start from the Webhooks/Pushers tab.
| Status and message | Cause | Fix |
|---|---|---|
| 401 "Authentication failed" | No token, a wrong token, or a token generated but not saved | On Webhooks/Pushers, select Save Settings. Send the token as Authorization: Bearer <your token> |
| 401 "Item webhook is not enabled for this shop", or the same for "User webhook" | The switch is off | Turn it on and save |
| 400 "Vendor webhook is not enabled for this shop" | Vendor type webhook is off | Turn it on and save |
| 402 "… is not included in your plan. …" | The plan does not include the feature | See Plan and access |
| 402 or 403 "The shop's plan has ended: it is read-only until it is renewed." | Only the two order endpoints still work | Renew under Shop › Plan & billing |
| 422 "Validation failed" | A field is missing or has the wrong type. data names each field | Correct the fields. Dates use YYYY-MM-DD HH:MM:SS |
| 429 | More than 500 requests in a minute | Send more rows in fewer calls |
/api/shop/...)| Status and message | Cause | Fix |
|---|---|---|
| "username or password incorrect" | Wrong e-mail or password, or not a shop owner or staff account | Use an owner or staff account |
| "invalid auth_token or user_id" | The token is not the one stored for that user, for example after Regenerate | Store the newest token |
| 403 "Unauthorized." | No Bearer token, or the token is refused | Send Authorization: Bearer <your token>, or sign in again |
| Symptom | Cause | Fix |
|---|---|---|
| Shop Webhooks is missing from the Shop menu | The plan does not include the feature | See Plan and access |
| Nothing arrives | The webhook is Paused, the event is not ticked, or it is a demo order | Edit the webhook. Test with a real order |
| Some events are missing | Your server failed three tries | Answer 2xx within 3 seconds. See delivery and retries |
| Your signature check fails | The body was parsed and serialised again, or the secret is wrong | Compute over the raw body. Ask support for your signing secret |
| No customer events arrive | They are sent only for customers with a partner ID | See events |
| Symptom | Cause | Fix |
|---|---|---|
| Enabled is locked with Managed by platform | The plan does not include "ERP & accounting (ERPNext, Zoho)" | See Plan and access |
| An order has no ERPNext order | It has not reached the trigger, or the attempt failed | Open the order. ERPNext Error: › View shows what ERPNext answered |
| Lines are missing from the Sales Order | Those products have no barcode | Add barcodes that match ERPNext item codes |