A datasource connection fails when authorization can’t complete or when initial sync doesn’t pull any data.
| Symptom | Likely cause | Fix |
|---|
| OAuth screen says “insufficient permissions” | The OAuth account doesn’t have the required source-platform role | Log in to the source platform with an account that has the required role; retry |
| Authorization completes but Ignyte IQ shows Disconnected | Token was revoked or source-side permissions changed | Reconnect via Settings → Integrations |
| Authorization screen never loads | Browser blocking pop-ups or third-party cookies | Allow pop-ups; try another browser |
| Connection succeeds but no data after 15 minutes | The OAuth account lacks read scope for the data | Confirm scopes match what’s documented in the integration’s page |
| Symptom | Fix |
|---|
| ”Invalid key” | Regenerate the key on the source platform; ensure no leading/trailing whitespace when pasting |
| ”Insufficient scope” | The key was generated with insufficient permissions. Regenerate with full read access |
| Connection accepts the key but no data appears | Confirm the source account has data to read; some platforms require a specific role even for read-only API keys |
| Symptom | Fix |
|---|
| Rows flagged as “unknown SKU” | The SKU doesn’t match the ecommerce datasource. Confirm exact spelling |
| File rejected on upload | Confirm CSV format matches the documented schema — column names and data types |
If the connection fails consistently after addressing the above, capture:
- The integration name
- The exact error message
- The source-platform account role (verified)
- The connection method (OAuth or API key)