Skip to main content

Troubleshooting

Common API errors

Quick fixes for the most common API errors.

Authentication errors

401 Unauthorized

Cause: Invalid or missing API key

Fix: Check your API key is correct and included in the Authorization header

403 Forbidden

Cause: API key doesn't have permission for this action

Fix: Upgrade your plan or check API key permissions

Request errors

400 Bad Request

Cause: Invalid email format or missing parameters

Fix: Validate email format before sending

422 Unprocessable Entity

Cause: Email is valid format but cannot be processed

Fix: Check the specific error message for details

Rate and quota errors

429 Too Many Requests

Cause: Rate limit exceeded

Fix: Implement backoff and retry, or upgrade plan

402 Payment Required

Cause: Out of credits

Fix: Purchase more credits or upgrade plan

Something wrong or missing here?

Tell us what to fix. Your email goes to the support team with this article's title already filled in.

Send feedback

Still need help?

Email support@kawaa.com. If your question is about a bulk job, include its job ID from the dashboard.

Contact support