Articles on: Integrations

Troubleshooting WordPress Errors

If you don't see your error below, contact us through the chat on koala.sh or email hello@koala.sh with the full error message and your site address.


Errors from your site appear in Koala AI as **WordPress returned HTTP <code>: **. Find the code below.


If you are using our plugin and you see an error, the plugin was most likely deactivated or the connection was removed. Check that the plugin is still active and the connection shows as connected on the plugin page.


How Koala AI connects to your site


Koala AI first connects to your site directly. If that request is blocked or fails, it retries through our proxy, which always uses the IP address 24.144.68.208. Every request identifies itself with the user agent KoalaWriter/1.0 (https://koala.sh/writer).


If you use a firewall (such as Cloudflare), a security plugin or a captcha plugin, allow both the user agent and the IP address. Most 400, 401, 403 and 429 errors on sites with security tools are fixed this way.


400 Error Code


  • Using the plugin: the plugin was deactivated. Reactivate it in Plugins and reconnect if needed.
  • Using the REST API: a firewall or security plugin rejected the request. Allow our user agent and IP address (see above).


401 Error Code


When using the plugin, this means the integration was disconnected from the plugin side. Reconnect it from the plugin page.


  • Error message:



  • Solutions:


  1. Try adding the integration again using your email address instead of your username. This often fixes the problem.
  2. If that doesn't work, go to Settings > Permalinks in WordPress and click Save Changes without changing anything. Brand new sites often need this (it's called flushing permalinks).
  3. If it still fails, check for security, captcha or login-protection plugins that restrict the API. Allow our user agent and IP address (see above), or pause the plugin and try again.


404 Error Code


This is usually caused by entering the wrong WordPress site domain.


For example, if your homepage is example.com then you must enter example.com.


If you have a custom login page, still enter example.com. Don't enter the address of your login page.


If WordPress is installed in a subdirectory such as example.com/guides, connect with the Koala AI WordPress plugin. The plugin sends your full site address, including the subdirectory. The REST API form on the Account page only accepts a domain.


429 or 403 Error Code


Your firewall (such as Cloudflare) or your server is blocking our connection.


Allow our user agent KoalaWriter/1.0 (https://koala.sh/writer) and our IP address 24.144.68.208, then try again.


500 Error Code


  • Error message:


500: {"code":"incorrect_password","message":"<strong>Error:<\/strong> The password you entered for the username <strong>koala283<\/strong> is incorrect. <a href=\"https:\/\/domain\/wp-login.php?action=lostpassword\">Lost your password?<\/a>","data":null}


  • Cause:


This error is caused by EasyWP hosting or by a plugin that breaks WordPress's built-in API authentication.


  • Solution:


If you use EasyWP, connect with the Koala AI WordPress plugin. The plugin doesn't use WordPress application passwords, so EasyWP's API problem doesn't affect it. (The old Application Passwords plugin was closed on wordpress.org in December 2025, so don't install it.)


Otherwise, if you have a plugin installed that changes how API authentication works, deactivate it and click Create Draft again.


Known plugin conflicts:


  • Basic API Authentication plugin
  • JSON Basic Authentication plugin


These are outdated plugins that should no longer be installed.


"Your server returned an unexpected response"


  • Error message:


Your server returned an unexpected response when we tried to create a draft using the built-in WordPress API. Likely you have a plugin that has disabled the API, or you are redirecting the API route. You need to check your plugins and ensure nothing is interfering with the API. Your server returned a 200 code and the following response:...


  • Cause:


Your server redirected us when we created the draft. This usually happens when your domain redirects to the www or non-www version and the other one was entered.


  • Solution:


  1. If your domain redirects to the www version, disconnect the WordPress integration in Koala AI and reconnect it using the www version.
  2. If your domain redirects to the non-www version, disconnect the WordPress integration in Koala AI and reconnect it using the non-www version.


Application Passwords have been disabled by Wordfence


  • Error message:



  • Cause:


The Wordfence plugin disables Application Passwords by default. This only affects the REST API connection.


  • Solution:


Go to Wordfence > All Options > Disable WordPress application passwords and make sure Application Passwords are enabled. You can also connect with the Koala AI WordPress plugin, which doesn't use them.

Updated on: 09/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!