Prerequisites
Before connecting Meta to Whathead, make sure you have:- A Facebook Business Manager account
- Admin access to the ad accounts you want to manage
- The necessary permissions to authorize third-party applications
Connection Steps
Click Connect
Click the Connect button on the Meta card. This will open a Facebook authentication window.
Log in to Facebook
If you’re not already logged in, enter your Facebook credentials. Use the account that has access to your Business Manager.
Select Business Manager
Choose the Business Manager account you want to connect. If you manage multiple Business Managers, select the one containing the ad accounts you’ll use.
Grant Permissions
Review the permissions Whathead is requesting:
- Read and manage ad accounts
- Access media library
- Create and edit campaigns, ad sets, and ads
- View campaign performance data
Required Permissions
Whathead requires the following Meta permissions to function properly:| Permission | Why it’s needed |
|---|---|
| ads_management | Create, edit, and publish campaigns, ad sets, and ads |
| ads_read | Fetch existing campaigns and view campaign data |
| business_management | Access Business Manager and ad account information |
| pages_read_engagement | Access Facebook Pages for ad creation |
| instagram_basic | Access Instagram accounts for Instagram placements |
Selecting Ad Accounts
After connecting your Business Manager, you’ll need to select which ad accounts to use:Select Ad Accounts
You’ll see a list of all ad accounts in your Business Manager. Check the boxes next to the accounts you want to use in Whathead.
Set Default Account
Choose one account as your default. This will be pre-selected when you create new campaigns.
Troubleshooting Connection Issues
Connection fails with 'Permission denied' error
Connection fails with 'Permission denied' error
Cause: You don’t have admin access to the Business Manager or ad accounts.Resolution:
- Verify you have admin or advertiser access in Facebook Business Manager
- Ask your Business Manager admin to grant you the necessary permissions
- Try connecting again after permissions are updated
Can't see my ad accounts after connecting
Can't see my ad accounts after connecting
Cause: The ad accounts may not be in the Business Manager you connected, or you don’t have access to them.Resolution:
- Log in to Facebook Business Manager and verify which accounts you have access to
- Make sure you connected the correct Business Manager
- If needed, disconnect and reconnect with a different Business Manager
Connection expires or shows as disconnected
Connection expires or shows as disconnected
Cause: Facebook access tokens expire after 60 days, or permissions were revoked.Resolution:
- Navigate to Integrations
- Click Reconnect on the Meta card
- Follow the authentication flow again to refresh your connection
Error: 'This app is not available in your region'
Error: 'This app is not available in your region'
Cause: Your Facebook account or Business Manager is in a region where Whathead is not yet available.Resolution:
Contact Whathead support to check if your region is supported or when support will be available.
Managing Multiple Business Managers
If you manage campaigns for multiple clients or businesses, you can connect multiple Business Manager accounts:- Complete the connection process for your first Business Manager
- Navigate back to Integrations
- Click Add Another Account on the Meta card
- Follow the same connection steps for the additional Business Manager