Skip to main content
AdStellar connects to Meta’s advertising platform to manage and launch your campaigns. This guide covers how to connect, sync, and troubleshoot your Meta integration.

​
Connecting Meta

1

Open Integrations

Navigate to Settings > Integrations from the sidebar.
2

Click Connect Meta

Click Connect Meta to begin the Facebook OAuth flow. You’ll be redirected to Facebook to authorize AdStellar.
3

Grant permissions

AdStellar requires the following permissions:
PermissionWhy it’s needed
ads_managementCreate and manage campaigns, ad sets, and ads
ads_readRead campaign performance data
business_managementAccess Business Manager assets and ad accounts
pages_read_engagementAccess Facebook Pages for ad delivery
If you skip any required permission, some features won’t work. You’ll need to reconnect and grant all permissions.
4

Sync ad accounts

After connecting, AdStellar automatically syncs your available ad accounts. Select which accounts you want to use and assign them to workspaces.

​
Data Sync

Once connected, AdStellar syncs the following data from Meta:
  • Campaigns — all campaigns in your connected ad accounts
  • Ad Sets — targeting and budget configurations
  • Ads — creative and delivery data
  • Performance Data — spend, impressions, clicks, conversions, and other metrics
Data syncs automatically on a regular schedule. You can also trigger a manual sync from the Integrations page.

​
Resyncing

Click Resync on the Integrations page to:
  • Refresh your OAuth token
  • Re-fetch all campaigns, ad sets, and ads
  • Update performance data
If you’ve made changes directly in Meta Ads Manager (like pausing campaigns or updating budgets), resync to pull those changes into AdStellar.

​
Disconnecting Meta

To disconnect your Meta account, click Disconnect on the Integrations page. This removes the OAuth connection but does not delete any data already synced to AdStellar.

​
Troubleshooting

​
Token Expiration

Meta OAuth tokens can expire, especially if you change your Facebook password or revoke app permissions. If your connection stops working:
  1. Go to Settings > Integrations
  2. Click Resync to refresh the token
  3. If resync fails, click Reconnect to go through the OAuth flow again

​
Missing Permissions

If features aren’t working as expected, you may have skipped a required permission during setup. Disconnect and reconnect Meta, making sure to grant all requested permissions.

​
Ad Account Not Appearing

If an ad account doesn’t show up after connecting:
  • Verify you have access to the account in Meta Business Manager
  • Check that the account is active (not disabled or closed)
  • Try resyncing to refresh the account list

​
Connection Health Banner

AdStellar displays a warning banner in the app when your Meta connection needs attention — for example, when a token is expiring soon or permissions have been revoked. Follow the banner instructions to resolve the issue.