Understand Rate Limits & Errors
Interpret authorization, permission, not-found, conflict, validation, rate-limit, and server errors.
Overview
401 Unauthorized: Missing, invalid, wrong-workspace, or revoked credential.
403 Forbidden: Key lacks scope or resource access.
404 Not Found: Wrong endpoint or resource ID.
409 Conflict: Duplicate or conflicting state.
422 Validation: Missing or incorrectly formatted field.
429 Rate Limit: Slow down and apply backoff.
5xx Server Error: Retry safely with backoff and idempotency.
Who should use it
Authorized developers and technical workspace users.
Before you begin
- Use a server-side integration environment.
- Create separate test and production credentials.
- Use HTTPS and least privilege.
- Never expose a key or webhook secret in client-side code.
Main concepts and fields
| Concept / Field | Meaning or Use |
|---|---|
| 4xx | Request, validation or permission error. |
| 5xx | Temporary server error. |
| 429 | Rate-limit response. |
| Backoff | Wait before retrying. |
| Request ID | Reference for investigation. |
Step-by-step instructions
- Open Wemblo -> Developer Menu.
- Define the integration purpose and data direction.
- Create the minimum required credential or subscription.
- Implement from a server-side environment.
- Validate requests and responses.
- Handle errors, retries and duplicates.
- Test with fictional data.
- Review logs.
- Rotate or revoke credentials when required.
Test and verification
- Complete one successful path with fictional data.
- Complete one invalid, failure or permission path.
- Confirm the result appears in the correct workspace and module.
- Confirm the correct person or team can review and continue the work.
Common issues and solutions
| Issue | What to Check |
|---|---|
| 401 Unauthorized | Missing, invalid, revoked or wrong-workspace key. |
| 403 Forbidden | Scope or resource permission. |
| 422 Validation | Required field or data format. |
| 429 Rate Limit | Backoff, volume and plan/API capacity. |
| Webhook retries | Endpoint response, signature, timeout and processing speed. |
Security, privacy, consent, cost and provider notes
- Use only data the business is authorized to process.
- External provider charges, policies, approvals, limits and availability remain separate.
- Do not expose passwords, API keys, tokens, webhook secrets, payment credentials or private customer data.
- Use human review for sensitive, regulated, urgent, financial or final decisions.
Last reviewed: