Common Integration Errors and How to Fix Them

Integration errors happen when Campaignly can't connect to your social accounts, email platforms, or other tools. Most issues are quick to resolve once you know what's happening.

OAuth Connection Failed

OAuth is the secure way Campaignly connects to your accounts. If you see "OAuth connection failed," try these steps:

1. Clear your browser cookies and cache
2. Log out of the connected platform (Facebook, Instagram, Google, etc.)
3. Return to Campaignly and attempt the connection again
4. When prompted, log in directly to that platform
5. Grant all requested permissions

If it still fails, the issue is usually on the platform's end. Wait 15 minutes and try again—sometimes their servers are overloaded.

Note: Use a personal account or admin account to authorize. Standard team members often lack the permissions needed for OAuth.

Expired or Invalid Tokens

Your access token—a digital key that keeps you connected—expires periodically. Campaignly refreshes these automatically, but sometimes the refresh fails.

You'll see messages like "Token expired" or "Invalid credentials."

1. Go to Settings → Connected Accounts
2. Find the account that's showing the error
3. Click the Disconnect button
4. Reconnect the account using the steps above
5. Verify permissions are fully granted

This creates a fresh token and usually resolves the issue immediately.

Permission Issues

If your campaign runs partway, then stops with a permission error, you likely didn't grant full access during setup.

What each permission enables:

• Manage posts – schedule and publish content
• View insights – pull analytics and reports
• Manage comments – reply to and moderate comments
• Access pages/accounts – see all your connected pages

1. Go to Settings → Connected Accounts
2. Disconnect the problematic account
3. Reconnect and review each permission carefully
4. Grant everything Campaignly requests
5. Save and test a small campaign

If a permission is grayed out, your account role on that platform doesn't support it. You'll need an admin or owner to reconnect instead.

"Account Not Found" Error

This happens when you delete or deactivate an account on the platform after connecting it to Campaignly.

1. Go to Settings → Connected Accounts
2. Disconnect the missing account
3. Reactivate or create a new account on the platform
4. Reconnect it in Campaignly

Multi-Account Issues

Managing multiple Facebook pages or Instagram profiles? If one fails but others work:

1. Disconnect all accounts from that platform
2. Reconnect them one at a time
3. Verify each has the right permissions

Sometimes one account blocks the entire connection. Isolating them helps identify which one.

Still Stuck?

If none of these fixes work:

• Check the platform's status page – service outages on their end will block Campaignly
• Verify your account is active – suspended or flagged accounts can't connect
• Contact support – include your username and the exact error message you're seeing

We can usually reconnect you within an hour.