Integration Troubleshooting

This guide covers troubleshooting integration issues after your accounts are connected. For initial connection problems, see Connection Issues.

Common Integration Problems

Integration Shows as “Inactive” or Disappears

Symptoms:

• Integration is missing from the “Active” tab
• Posts fail to publish
• Analytics don’t load

Causes:

• Authentication token expired
• Permissions revoked on the platform
• Platform account suspended or restricted

Fix:

1. Go to Integrations (/integrations)
2. Switch to the Available tab
3. Find the platform (e.g., Instagram, Facebook)
4. Click Connect (or Connect Another)
5. Log in and grant permissions again
6. This will refresh your existing connection or re-add it

Posts Fail to Publish

Symptoms:

• Posts scheduled but never publish
• Error messages in publishing queue
• “Authentication failed” errors

Fix:

1. Check the Publishing Errors guide for error details
2. If error is “Authentication failed”, reconnect the integration (see above)
3. If error is content-related, fix the content issue
4. Retry the failed post

Analytics Not Loading

Symptoms:

• Analytics dashboard shows “Loading…” indefinitely
• Error message: “Failed to load analytics”
• No data showing for connected accounts

Causes:

• Integration token expired
• Platform API restrictions
• Rate limiting

Fix:

1. Reconnect the integration - Go to the Available tab and click Connect to refresh the token
2. Wait a few minutes - Analytics data may be cached and updating
3. Check platform status - Some platforms restrict API access temporarily
4. Refresh the page - Sometimes a simple refresh fixes loading issues

Integration Disconnects Frequently

Symptoms:

• Integration works for a while then disconnects
• Need to reconnect often
• Authentication errors appear regularly

Causes:

• Password changed on platform account
• Permissions revoked
• Platform security settings changed

Fix:

1. Don’t change passwords - If you must change your password, you must reconnect the integration immediately after
2. Don’t revoke permissions - Keep IDEQO’s access granted on the platform
3. Check platform security settings - Some platforms have security features that disconnect apps

Reconnecting Channels

When to Reconnect

Reconnect an integration when:

• Integration disappears from the “Active” list
• Posts fail with authentication errors
• Analytics don’t load
• You changed your platform password
• You revoked IDEQO’s permissions

How to Reconnect

1. Go to Integrations (/integrations)
2. Click the Available tab
3. Find the platform you want to reconnect
4. Click Connect (or Connect Another)
5. Log in to the platform and grant all requested permissions
6. You’ll be redirected back to IDEQO
7. The integration should be active again in the “Active” tab

💡 Tip

After reconnecting, check your publishing queue to see if any failed posts can now be retried. You may need to reschedule posts that failed due to authentication errors.

Reconnecting Specific Platforms

Instagram

1. Go to Integrations → Available tab
2. Find Instagram and click Connect
3. Log in to Facebook (Instagram uses Facebook authentication)
4. Select the Facebook Page linked to your Instagram account
5. Grant permissions
6. Select your Instagram Business/Creator account

Note: Your Instagram account must be linked to a Facebook Page for API access.

Facebook

1. Go to Integrations → Available tab
2. Find Facebook and click Connect
3. Log in to Facebook
4. Select the Page you want to connect
5. Grant all requested permissions
6. Make sure you’re an admin of the Page

LinkedIn

1. Go to Integrations → Available tab
2. Find LinkedIn and click Connect
3. Log in to LinkedIn
4. Select the Company Page you want to connect
5. Grant permissions
6. Make sure you’re an admin of the Page

Twitter/X

1. Go to Integrations → Available tab
2. Find Twitter and click Connect
3. Log in to Twitter/X
4. Authorize IDEQO
5. Grant permissions

Fixing Integration Errors

Error: “Token Expired”

Fix:

1. Go to the Available tab
2. Connect the platform again
3. This refreshes the authentication token
4. Posts should publish successfully after reconnecting

Error: “Permission Denied”

Fix:

1. Go to the platform’s app settings (on Instagram, Facebook, etc.)
2. Find IDEQO in connected apps
3. Make sure all permissions are granted
4. Reconnect via the Available tab if needed

Error: “Rate Limit Exceeded”

Fix:

1. Wait a few hours before trying again
2. Reduce posting frequency
3. Check platform-specific rate limits
4. Some platforms have daily or hourly limits

Error: “Account Suspended”

Fix:

1. Check your platform account status directly on the social network
2. Resolve any issues with the platform
3. Reconnect after account is restored
4. Contact platform support if needed

Platform-Specific Troubleshooting

Instagram Issues

Problem: “No Professional Account Found”

• Fix: Convert to Business/Creator account in Instagram app

Problem: “Facebook Page Not Linked”

• Fix: Link Instagram account to a Facebook Page in Instagram settings

Problem: “Page Admin Required”

• Fix: Make sure you’re an admin of the linked Facebook Page

Facebook Issues

Problem: “Personal Profile Not Supported”

• Fix: Connect a Facebook Page, not your personal profile

Problem: “Page Not Published”

• Fix: Publish the Page in Facebook settings before connecting

Problem: “Admin Access Required”

• Fix: Make sure you’re an admin of the Page you’re connecting

LinkedIn Issues

Problem: “Company Page Required”

• Fix: Connect a LinkedIn Company Page, not your personal profile

Problem: “Admin Access Required”

• Fix: Make sure you’re an admin of the Company Page

Twitter/X Issues

Problem: “API Access Denied”

• Fix: Twitter/X API access may be restricted. Contact support.

Problem: “Account Verification Required”

• Fix: Some Twitter/X features require verified accounts

Maintaining Healthy Integrations

Best Practices

1. Don’t revoke permissions - Keep IDEQO’s access granted
2. Monitor integration status - Check integrations regularly
3. Reconnect proactively - If you see warnings, reconnect before issues occur
4. Keep platform accounts active - Don’t suspend or restrict platform accounts

Regular Maintenance

• Weekly: Check integration status in the Active tab
• Monthly: Review failed posts and reconnect if needed
• After password changes: Always reconnect integrations
• After platform updates: Check if reconnection is needed

Getting Help

If you’ve tried everything and still have issues:

1. Check error messages - Note the exact error you see
2. Check integration status - See if it’s active or inactive
3. Try reconnecting - Often fixes most issues
4. Contact support - Contact support with:
   • Platform name
   • Error message
   • When the issue started
   • What you’ve tried