Skip to content
  • There are no suggestions because the search field is empty.

Troubleshooting LeadSimple API Key Errors

Fix the most common LeadSimple connection errors — wrong key type, missing scopes, and field-mapping mismatches.

If you're connecting Rescover to LeadSimple and the API key is being rejected, it's almost always one of three things. Work through them in order.

1. Confirm you're using the right API key from the right LeadSimple account

LeadSimple has two key types: an account-level API key (for system integrations) and per-user keys. Rescover needs the account-level API key. To find it in LeadSimple:

  1. In LeadSimple, click your initials (top right) → Settings → API Keys.
  2. If you don't see an account-level key, generate one. You'll need an admin role on the LeadSimple account.
  3. Copy the key in full — including any prefix (e.g., ls_) and trailing characters. Spaces or partial copies are the most common cause of rejection.

2. Paste the key in the right place in Rescover

In Rescover, go to Settings → CRM → CRM Connection (not Settings → CRM → Pipeline Settings). The integration screen has a clearly labeled LeadSimple API Key field. Paste, click Save, and watch for the green confirmation. A red "Unhandled error" means the key wasn't accepted — usually because of step 1, or because LeadSimple blocked the request.

3. Check the LeadSimple webhook permissions

For two-way sync (Rescover sending leads into LeadSimple, LeadSimple updating contact status back to Rescover), the API key needs Contacts and Pipelines read/write scopes. If your LeadSimple admin restricted the key, regenerate one with the correct scopes.

Common error messages

  • "Unhandled error" or 401 from LeadSimple — the key is invalid, expired, or the account-level/per-user mismatch above. Regenerate the key in LeadSimple and try again.
  • "Pipeline not found" — Rescover is connected, but the Pipeline ID it's trying to push to doesn't exist in LeadSimple. Open Settings → CRM → Pipeline Settings and pick a current pipeline from the dropdown.
  • "Lead created but missing fields" — Rescover is connected and pushing leads, but field mapping is wrong. See Settings → CRM → Field Mapping and confirm each Rescover field maps to a real LeadSimple field. New custom fields in LeadSimple don't auto-show; click Refresh.
  • "AutoPilot synced but only sent investor info, not the lead" — that's a field-mapping issue. The lead's name, address, and analysis link need to be mapped explicitly. See AutoPilot's CRM section in AutoPilot.

If none of the above works

Open a support ticket from the Help menu with:

  • The exact error message Rescover shows you.
  • The LeadSimple account email (we don't need the key itself).
  • A screenshot of your Settings → CRM → CRM Connection page.

Most LeadSimple ticket resolutions take less than a business day once we have the error text and a screenshot.

Related