How syncing works
After the initial full sync, Butterflai uses incremental syncing - only new or updated data since the last sync is fetched. This keeps your data current without unnecessary load on your external platforms.
Syncs run automatically on a regular schedule. The Last synced timestamp on each integration card shows when data was last pulled.
Force Sync Now
If you need the latest data immediately - for example, after a major campaign launch or at month-end close - use the Force Sync Now button on the integration card. This triggers an immediate incremental sync outside the regular schedule.
What "Expiring Soon" means
Integrations that use OAuth (Meta, TikTok, Google My Business) rely on access tokens that expire periodically. When a token is approaching expiration, the status indicator changes to Expiring Soon.
When you see this status, re-authenticate the integration by clicking the integration card and following the OAuth login flow again. This refreshes the token and ensures uninterrupted syncing.
Common issues and solutions
Connection error The external platform is unreachable or returned an error. Wait a few minutes and try Force Sync Now. If the issue persists, check the external platform's status page.
Expired token OAuth tokens have expired. Re-authenticate by clicking the integration card and signing in again.
Permission denied The account used to connect no longer has sufficient permissions. For service-account integrations (GA4, Google Ads, Search Console), verify the service account email still has access in the external platform. For OAuth integrations, re-authenticate with an account that has the required permissions.
Sync appears stuck If the Last synced timestamp has not updated after an expected sync cycle, try Force Sync Now. If it remains stuck, delete the integration and re-create it.
How to re-authenticate an integration
Go to Settings > Integrations.
Locate the integration showing Expiring Soon or a connection error.
Click the integration card.
For OAuth integrations: click Connect and sign in again.
For service-account integrations: verify your credentials are still valid and click Save.
Where synced data appears
All synced integration data is stored in the Document Library under the Integration Files section. Each integration creates its own set of data tables. This data is automatically available to the AI for answering questions, building dashboards, and powering KPI widgets.