Docs
/
Troubleshooting

Troubleshooting

WordPress connection issues

Common reasons a WordPress connection breaks, from Application Passwords to REST access.

July 25, 2026

WordPress connects over HTTPS using an Application Password rather than a login you share, so most connection problems trace back to that credential or to the account it belongs to.

Common causes

  • The Application Password was revoked or regenerated. WordPress lets you revoke individual Application Passwords from Users → Profile without affecting your main login. If the one HarperFlow uses gets revoked or a new one is generated in its place, the old one stops working immediately.
  • The connected user account changed. If the WordPress user HarperFlow authenticates as is deleted, or demoted below Editor/Administrator, HarperFlow loses the permissions it needs to publish.
  • A security plugin or host firewall started blocking REST requests. Some security plugins and hosting firewalls can restrict or disable the WordPress REST API (/wp-json/) after the fact, which is what HarperFlow publishes through.
  • The site lost HTTPS. Application Passwords require HTTPS; a lapsed or misconfigured SSL certificate breaks the connection until it's restored.

What you'll see

A broken WordPress connection shows the same reconnect banner as any other platform, and publishing pauses until it's fixed. See Reconnecting and token health for the general flow and the 14-day timeline before HarperFlow pauses billing on an unresolved connection.

The SSO key

If one-click sign-in from your wp-admin stops working specifically (while publishing still works, or vice versa), it's usually the separate SSO key rather than the Application Password. Reconnecting resets both.

Fixing it

Reconnect from your Your Site page using the same three fields as the original setup: your site URL, your WordPress username, and a freshly generated Application Password. See Connect your WordPress site for exactly where to generate one.

Note: Reconnecting doesn't change where your articles go or how they're categorized. It only refreshes the credential HarperFlow authenticates with.


More in Troubleshooting

Browse all Troubleshooting guides