Reference
Error catalog
Search this page for the exact message you see. Each entry names the cause and the fix — most resolve without contacting support.
Connection errors
| Message | Meaning | Fix |
|---|---|---|
| invalid_grant | The OAuth authorization code expired or was reused. | Restart the connect flow from Connections. |
| insufficient_scope | Fewer permissions were approved than CrowPrime requested. | Reconnect and accept all requested permissions. |
| seller_not_professional | The Amazon plan does not allow API access. | Upgrade to a Professional selling plan, then reconnect. |
| shop_not_active | The Etsy shop is in vacation mode or closed. | Reopen the shop, then reconnect. |
| rate_limited | The channel API quota is exhausted. | No action; CrowPrime retries automatically with backoff. |
| expired / revoked | Tokens passed their lifetime or were revoked at the channel. | Use Reconnect with the same marketplace account. |
invalid_grant
- Meaning
- The OAuth authorization code expired or was reused.
- Fix
- Restart the connect flow from Connections.
insufficient_scope
- Meaning
- Fewer permissions were approved than CrowPrime requested.
- Fix
- Reconnect and accept all requested permissions.
seller_not_professional
- Meaning
- The Amazon plan does not allow API access.
- Fix
- Upgrade to a Professional selling plan, then reconnect.
shop_not_active
- Meaning
- The Etsy shop is in vacation mode or closed.
- Fix
- Reopen the shop, then reconnect.
rate_limited
- Meaning
- The channel API quota is exhausted.
- Fix
- No action; CrowPrime retries automatically with backoff.
expired / revoked
- Meaning
- Tokens passed their lifetime or were revoked at the channel.
- Fix
- Use Reconnect with the same marketplace account.
Billing & access errors
| Message | Meaning | Fix |
|---|---|---|
| 403 SubscriptionRequired | The organization is SUSPENDED and the write was blocked. | Fix payment under Settings → Billing. |
| Account suspended due to subscription status | Banner for SUSPENDED organizations. | Same as above; data and exports remain available. |
| Seat limit reached | All plan seats are taken; invitations and acceptances stop. | Remove a member or upgrade the plan. |
| AI credits exhausted | The monthly Crow AI allowance is at zero. | Wait for the monthly reset or upgrade. |
| Page not available for your role | Your role lacks the page permission. | Ask an Owner to change your role or grant an override. |
403 SubscriptionRequired
- Meaning
- The organization is SUSPENDED and the write was blocked.
- Fix
- Fix payment under Settings → Billing.
Account suspended due to subscription status
- Meaning
- Banner for SUSPENDED organizations.
- Fix
- Same as above; data and exports remain available.
Seat limit reached
- Meaning
- All plan seats are taken; invitations and acceptances stop.
- Fix
- Remove a member or upgrade the plan.
AI credits exhausted
- Meaning
- The monthly Crow AI allowance is at zero.
- Fix
- Wait for the monthly reset or upgrade.
Page not available for your role
- Meaning
- Your role lacks the page permission.
- Fix
- Ask an Owner to change your role or grant an override.
Order & sync states
| State | Meaning | Fix |
|---|---|---|
| degraded | Channel errors or rate limits above threshold. | Monitor; sync continues partially with retries. |
| Needs attention | Oversold items, overdue shipments or failed pushes. | Open the queue and resolve each item. |
| currency mismatch | Order currency differs from the organization currency. | Finance reviews; amounts used the import-date rate. |
| Unlinked listing | An imported listing matched no variant. | Link it manually or create a product from it. |
| Channel rejected a push | The marketplace refused a stock or price update. | Automatic retry with backoff; check the listing flag for the channel message. |
degraded
- Meaning
- Channel errors or rate limits above threshold.
- Fix
- Monitor; sync continues partially with retries.
Needs attention
- Meaning
- Oversold items, overdue shipments or failed pushes.
- Fix
- Open the queue and resolve each item.
currency mismatch
- Meaning
- Order currency differs from the organization currency.
- Fix
- Finance reviews; amounts used the import-date rate.
Unlinked listing
- Meaning
- An imported listing matched no variant.
- Fix
- Link it manually or create a product from it.
Channel rejected a push
- Meaning
- The marketplace refused a stock or price update.
- Fix
- Automatic retry with backoff; check the listing flag for the channel message.
Refund failures
| Cause | Meaning | Fix |
|---|---|---|
| Refund window expired | The channel no longer accepts API refunds for the order. | Settle in the seller portal, then record as externally settled. |
| Insufficient balance | The marketplace balance cannot cover the refund. | Top up or settle externally, then record it. |
| Already refunded | The amount was refunded before, possibly on the channel. | Check the credit notes; record the portal refund if missing. |
| Partial API refusal (Etsy) | The channel refused a per-payment partial refund. | CrowPrime keeps the credit note marked as manually settled. |
Refund window expired
- Meaning
- The channel no longer accepts API refunds for the order.
- Fix
- Settle in the seller portal, then record as externally settled.
Insufficient balance
- Meaning
- The marketplace balance cannot cover the refund.
- Fix
- Top up or settle externally, then record it.
Already refunded
- Meaning
- The amount was refunded before, possibly on the channel.
- Fix
- Check the credit notes; record the portal refund if missing.
Partial API refusal (Etsy)
- Meaning
- The channel refused a per-payment partial refund.
- Fix
- CrowPrime keeps the credit note marked as manually settled.