Integration won't connect

If you're having trouble connecting an integration like your CRM, calendar, or email to Quin, this usually happens because of permission issues, authentication errors, or organizational security settings.

Before you begin

Make sure your integrations are connected in Settings > Integrations. Most connection issues occur because an integration disconnected without showing an error. Also, have your login credentials ready for the tool you're trying to connect. Some integrations require admin approval from your organization before they'll connect.

Troubleshooting

"Authentication failed" error when connecting

• Make sure you're using the correct email and password for the tool
• Check if your organization requires two-factor authentication and complete that step
• Try logging into the tool directly first to verify your credentials work
• Clear your browser cookies and cache, then try connecting again
• Use the same browser where you're already logged into the tool

Integration keeps disconnecting automatically

• Your organization may have security policies that expire authentication tokens
• Check if the tool recently updated its API or security requirements
• Verify you granted all requested permissions during initial setup
• Try fully removing the integration in Settings > Integrations and reconnecting from scratch
• Contact your organization's IT admin to whitelist Quin's integration

"Permission denied" when trying to connect

• You may not have the required role or permissions in the tool
• Check with your organization's administrator about integration permissions
• Some tools require admin approval before third-party apps can connect
• Verify your account has an active paid license if the tool requires it
• Grant all permissions requested during the connection process (not just basic access)

Can't find my organization or workspace

• Make sure you're logged into the correct account before connecting
• Try typing your full organization name or workspace URL
• Check that your organization allows third-party integrations
• Verify you're a member of the workspace you're trying to connect
• Contact your administrator to enable Quin access for your organization

Connection works but data isn't syncing

• The connection succeeded but permissions may be limited
• Go to Settings > Integrations, click the integration, and review permissions
• Disconnect and reconnect, making sure to grant all permissions
• Check if you have access to the specific records or data you're trying to sync
• Verify the integration doesn't have filters limiting what syncs

Google Calendar or Gmail won't connect

• Make sure you're using a Google account (not Microsoft or other provider)
• Check if your organization restricts third-party app access in Google Workspace
• Try the connection in an incognito/private browser window
• Verify you selected all calendar and email permissions during setup
• If using multiple Google accounts, make sure you're signed into the right one

Microsoft Outlook or Exchange won't connect

• Verify your organization allows OAuth connections to third-party apps
• Check if your admin needs to consent to the Quin app in Azure AD
• Try using Microsoft Exchange instead if Outlook doesn't work (or vice versa)
• Make sure you have an active Exchange license
• Contact your IT department about enabling Quin in your tenant

CRM (Salesforce, HubSpot, Pipedrive) won't connect

• Verify you have the necessary user role in your CRM (usually "Standard User" or higher)
• Check that your CRM subscription includes API access
• Make sure you're connecting to the correct CRM instance or portal
• Grant all requested permissions including read, write, and update access
• Ask your CRM administrator to add Quin as an approved connected app

What to expect

After successfully connecting an integration, initial sync can take 2-5 minutes. You'll see a green "Connected" status in Settings > Integrations when everything is working correctly.

How to reconnect an integration

1. Go to Settings > Integrations
2. Find the disconnected integration
3. Click Disconnect to fully remove it
4. Click Connect to start fresh
5. Grant all requested permissions during the new connection
6. Wait for the "Connected" confirmation

If an integration continues to fail after multiple attempts, contact support with screenshots of the error messages.