Common Errors and Solutions

This quick-reference guide covers the most frequent issues TableSync users encounter and how to resolve them.

Connection Errors

"Connection limit reached"

What it means: You've connected the maximum number of integrations for your plan.

Your options:

1. Upgrade your plan - Get more integrations with Starter, Pro, or Team plans
2. Disconnect unused integrations - Free up a slot by removing an integration you don't need

How to check your limit:

• Free: 1 integration
• Starter: 3 integrations
• Pro: 10 integrations
• Team: Unlimited

[Screenshot: Dashboard showing connection limit message]

"Authentication failed"

What it means: Your connection token expired or was revoked.

Solution: Reconnect the integration

Prevention: Don't revoke access in the source platform unless intentional.

"Integration not responding"

What it means: The source service (HubSpot, Shopify, Mailchimp) is temporarily unavailable.

Solution:

1. Wait 5-10 minutes
2. Check the source service's status page
3. Try again

Note: This is rare and usually resolves quickly.

Sync Limit Errors

"Monthly sync limit reached"

What it means: You've used all syncs for the current billing period.

How to check:

• Look at the stats card on your Dashboard
• Shows "X of Y syncs used this month"

Solutions:

1. Wait for reset - Limits reset on your billing date
2. Upgrade your plan - Get more syncs immediately

Plan limits:

[Screenshot: Stats card showing sync usage]

"Sync frequency not available"

What it means: Your plan doesn't include the selected sync frequency.

Solutions:

1. Choose a slower frequency (daily instead of hourly)
2. Upgrade to a plan that includes faster syncs

Frequency by plan:

Airtable Errors

"Table not found"

What it means: The Airtable table was deleted or renamed.

Solution:

1. Go to your Dashboard
2. Click the affected sync
3. Click Edit
4. Select the correct table (or create a new one)
5. Save

"Field not found" or "Column missing"

What it means: A mapped Airtable column no longer exists or was renamed.

Solution:

1. Edit the sync
2. Go to field mapping
3. Update mappings for the missing fields
4. Save

Prevention: Rename columns in Airtable only after pausing syncs.

"Base not found"

What it means: The Airtable base was deleted or you no longer have access.

Solutions:

1. Check if the base exists in Airtable
2. Reconnect Airtable and grant access to that base
3. If deleted, create a new sync to a different base

"Cannot write to Airtable" or "Write permission denied"

What it means: TableSync doesn't have permission to write to that base.

Solution:

1. Reconnect Airtable
2. When selecting bases, make sure to include this base
3. Grant both read and write access

"Field type mismatch"

What it means: Data doesn't match the Airtable column type.

Common examples:

• Text going into a Number field
• Date formatted incorrectly for Date field
• Multiple values going into a Single Select field

Solution:

1. Edit the sync
2. Either:

• Change the Airtable column type
• Map to a different (compatible) column
• Skip the problematic field

Source Data Errors

"Rate limit exceeded"

What it means: Too many API requests to HubSpot, Shopify, or Mailchimp.

Solution:

1. Wait 15-60 minutes (limits reset automatically)
2. Retry the sync manually

Prevention:

• Use hourly or daily syncs instead of 15-minute
• Don't trigger many manual syncs in quick succession

[Screenshot: Error message showing rate limit]

"Invalid data format"

What it means: Some records have malformed or unexpected data.

Solution:

1. Check the sync log for specific records
2. Review those records in your source system
3. Fix the data issues
4. Retry the sync

"Record too large"

What it means: A record exceeds size limits (usually from very long text fields).

Solution:

1. Check for unusually large text content in the source
2. Consider mapping to a Long Text field in Airtable
3. Or skip that field if not essential

Account Errors

"Account suspended"

What it means: There's a billing issue with your account.

Solution:

1. Check your email for billing notifications
2. Go to Manage Billing on your Dashboard
3. Update your payment method
4. Contact support if issues persist

"Plan downgrade pending"

What it means: You're switching to a lower plan, but it hasn't taken effect yet.

Note: Downgrades happen at the end of your billing period. Until then, your current plan limits apply.

Getting More Help

When to Contact Support

Contact support@tablesync.io when:

• Error persists after trying solutions above
• You see an error not listed here
• You need help understanding the error
• Something seems wrong even without an error message

Information to Include

Help us help you faster by providing:

1. Error message - Exact text, or a screenshot
2. Sync ID - Found in the URL when viewing a sync
3. Timestamp - When did this start happening?
4. What you tried - Steps you've already taken
5. Frequency - Is it every sync or intermittent?

Support Response Times

• Business days: Within 24 hours
• Urgent issues: Mark your email as urgent
• Weekends: Response on next business day

Quick Reference Table

Frequently Asked Questions

Why did my sync fail overnight?

Most common causes: rate limits, expired tokens, or Airtable changes. Check the sync log for details.

Can I retry all failed syncs at once?

Currently, you need to retry each sync individually. Click Sync Now on each failed sync.

My sync succeeded but I see fewer records than expected.

Some records may have been skipped due to data issues. Check the sync log for details. Also verify your source actually has the records you expect.

Why do I keep hitting rate limits?

You may have too many syncs running at 15-minute intervals. Try spreading syncs to hourly or stagger their start times.

How can I be notified when syncs fail?

Go to Settings and enable email notifications for sync failures.