How to Reconnect an Integration

If an integration shows as disconnected or syncs are failing due to authentication, you'll need to reconnect. This is a normal maintenance task and your data and configurations are preserved.

When You Need to Reconnect

Reconnecting is required when:

• The connection shows as "Disconnected" on your Dashboard
• Syncs fail with "authentication" or "unauthorized" errors
• You changed your password on the source service
• You revoked TableSync's access from the source platform
• The OAuth token expired (rare, usually after many months)

[Screenshot: Dashboard showing a disconnected integration with warning]

Signs Your Connection Needs Refreshing

Step-by-Step Reconnection

For Any Integration (Airtable, HubSpot, Shopify, Mailchimp)

1. Go to your Dashboard
2. Find the integration that needs reconnecting
3. Look for the Reconnect button (or click the three-dot menu)
4. Click Reconnect

[Screenshot: Integration card with Reconnect button highlighted]

Complete the Authorization

1. A popup window will open
2. Log in to the service if prompted
3. Review and approve the permissions (same as original setup)
4. Wait to be redirected back to TableSync

[Screenshot: OAuth authorization screen for reconnection]

Verify the Connection

1. The integration card should show "Connected" with a green indicator
2. Check that your account name/email is displayed correctly
3. Your syncs should resume automatically

[Screenshot: Successfully reconnected integration showing Connected status]

What Happens to Your Data

When you reconnect:

Important: Reconnecting does NOT delete or reset anything. It only refreshes the authentication.

After Reconnecting

Run a Manual Sync

After reconnecting, you may want to catch up on missed data:

1. Find each sync that uses this integration
2. Click Sync Now to trigger an immediate sync
3. Check that it completes successfully

Check for Missed Data

If the integration was disconnected for a while:

1. Review what timeframe was missed
2. The next sync will pull current data
3. Historical data from during the disconnection may not sync
4. For HubSpot/Shopify/Mailchimp: only currently-existing records sync

Provider-Specific Notes

Airtable Reconnection

• Re-select which bases TableSync can access
• Consider granting access to all bases for convenience
• Existing base/table selections in syncs should still work

HubSpot Reconnection

• Make sure you select the same HubSpot portal
• Permissions requested are the same as initial connection
• Custom properties will still be available

Shopify Reconnection

• Enter the same store URL
• The app may show as needing "re-installation"
• Your store data access remains the same

Mailchimp Reconnection

• Ensure you log into the correct Mailchimp account
• Audience access remains as before
• Merge fields and tags stay available

Troubleshooting Reconnection Issues

"Pop-up was blocked"

Solution:

1. Look for a blocked popup indicator in your browser address bar
2. Click it and allow popups from tablesync.io
3. Try reconnecting again

"Authorization denied"

Possible causes:

• You're logged into the wrong account
• Your account permissions changed
• Two-factor authentication issue

Solution:

1. Log out of the service completely in your browser
2. Try reconnecting and log in fresh
3. Make sure you approve all permission requests

"Connection shows connected but syncs still fail"

Possible causes:

• Cache issue
• Partial reconnection

Solution:

1. Refresh your Dashboard page
2. Try disconnecting completely, then reconnecting
3. Check the specific sync error messages

"I can't find the Reconnect button"

If a connection doesn't show as disconnected but syncs fail:

1. Click the three-dot menu on the integration card
2. Select Disconnect
3. Then click Connect to reconnect fresh

Preventing Future Disconnections

Password Changes

When you change your password on any integrated service:

1. Expect that TableSync will need reconnection
2. Reconnect proactively right after changing your password
3. Don't wait for syncs to fail

Revoking Access

If you need to revoke TableSync's access from a source platform:

1. First, pause or delete syncs in TableSync
2. Then revoke access in the source platform
3. If you want to use TableSync again later, reconnect

Monitoring

Check your Dashboard regularly:

• Look for warning badges on integration cards
• Enable email notifications for failures
• Address issues promptly before they affect multiple syncs

Frequently Asked Questions

How often do I need to reconnect?

Most connections last indefinitely. Reconnection is usually only needed after password changes or manual access revocation.

Will I lose my sync configurations?

No. All sync settings, field mappings, and schedules are preserved.

Do I need to reconnect all my syncs individually?

No. Reconnecting the integration fixes all syncs that use it.

What if I reconnect to a different account?

Syncs referencing the old account's data will fail. Make sure you reconnect to the same account.

Can I reconnect while syncs are running?

Yes, but running syncs may fail. It's best to wait for syncs to complete or pause them first.