Skip to main content
owlie
Sign Up Free

Connector Failures

Who this is for​

Admins diagnosing connector sync and authentication issues.

Goal​

Identify and fix common connector failures quickly.

Prereqs​

  • /implement/setup/first-connector

Success criteria​

The connector sync succeeds and identities appear in the Admin Dashboard.

Symptom: connection test fails​

  • Likely cause: invalid credentials or missing scopes.
  • Fix: regenerate credentials and re‑run the test on /admin/integrations/:integration.

Symptom: sync completes but no identities appear​

  • Likely cause: insufficient read scopes or filter misconfiguration.
  • Fix: confirm the connector has directory read permissions.

Symptom: sync is slow or times out​

  • Likely cause: large tenant or rate limits on the source system.
  • Fix: reduce scope and re‑sync, then expand gradually.

Example​

Okta sync fails with 401. Regenerate the API token, update the connector, then re‑run sync.

Troubleshooting​

  • Always validate credentials outside Owlie first if possible.

Assumptions & Questions​

  • What error messages are shown in the connector UI?

Next steps​

  • /troubleshooting/ingestion-correlation
  • /implement/requests/access-requests