Connection Issues #
“Connection Lost” or “Token Expired” #
The OAuth2 token may have failed to refresh. Try:
- Go to GHL CRM → Settings → Connection.
- Click Disconnect.
- Click “Connect with GoHighLevel” to re-authorize.
If the issue persists, check that your site uses HTTPS and that your GHL account has API access enabled.
“Circuit Breaker Active” #
After 3 consecutive auth failures, the plugin enters a 5-minute cooldown. Wait 5 minutes and the connection will automatically retry.
Sync Issues #
“Contact Not Found” #
The GHL contact may have been deleted or merged. The plugin automatically attempts to re-find the contact by email.
Duplicate Contacts #
The plugin has built-in duplicate prevention (10-second per-user lock, POST→PUT conversion on duplicate errors). If duplicates still occur, check if you have other plugins or Zapier automations creating contacts in parallel.
Sync Queue Not Processing #
- Ensure WordPress Cron or a server cron job is running.
- Check if the Action Scheduler is functioning: go to Tools → Scheduled Actions.
- Verify your PHP memory limit is at least 256 MB.
