Troubleshooting
Connection Issues
| Error | Cause | Solution |
|---|---|---|
| Connection failed | Invalid URL or network issue | Verify base URL is correct and accessible |
| 401 Unauthorized | Invalid credentials | Check API key, token, or username/password |
| 403 Forbidden | Missing permissions | Verify API credentials have read access |
| 404 Not Found | Wrong endpoint path | Check tenants/properties endpoint URLs |
| SSL Error | Certificate issue | Ensure URL uses HTTPS with valid certificate |
Sync Issues
| Problem | Cause | Solution |
|---|---|---|
| 0 records synced | Wrong endpoint or empty response | Test endpoint in browser/Postman first |
| Missing data | Field mapping incomplete | Check field mapping, ensure required fields mapped |
| Duplicate records | ID field not mapped | Ensure external_id is correctly mapped |
| Sync takes too long | Large dataset or slow API | Try syncing tenants and properties separately |
OAuth2 Issues
| Error | Cause | Solution |
|---|---|---|
| invalid_grant | Refresh token expired or revoked | Re-authenticate with your PMS |
| invalid_client | Wrong Client ID or Secret | Verify OAuth2 credentials |
| Token refresh failed | Wrong token URL | Check token endpoint URL |
| Access denied | Missing scopes | Request proper API scopes from PMS |