Connection Issues
Cannot connect Meta account
Cannot connect Meta account
- You don’t have admin access to the Business Manager
- Your Facebook account is restricted
- You’re in a region where Whathead is not available
- Browser is blocking the authentication popup
- Verify you have admin or advertiser access in Facebook Business Manager
- Check that your Facebook account is in good standing (not restricted)
- Disable popup blockers and try again
- Try using a different browser (Chrome or Firefox recommended)
- Clear browser cache and cookies, then retry
- If still failing, contact Whathead support with the error message
Connection shows as expired or disconnected
Connection shows as expired or disconnected
- Access token expired (Meta tokens expire after 60 days)
- Permissions were revoked in Facebook Business Manager
- Business Manager admin removed your access
- Navigate to Integrations in Whathead
- Click Reconnect on the Meta card
- Follow the authentication flow again
- Verify all permissions are granted
- If reconnection fails, check your Business Manager access
Cannot see my ad accounts after connecting
Cannot see my ad accounts after connecting
- Ad accounts are in a different Business Manager
- You don’t have access to any ad accounts in the connected Business Manager
- Ad accounts are disabled or restricted
- Log in to Facebook Business Manager and verify which ad accounts you have access to
- Check that you connected the correct Business Manager (if you manage multiple)
- Verify ad accounts are active and not disabled
- If accounts are in a different Business Manager, disconnect and reconnect with the correct one
- Ask your Business Manager admin to grant you access to the ad accounts
Error: 'This app is not available in your region'
Error: 'This app is not available in your region'
- Your Facebook account or Business Manager is registered in an unsupported region
- Regional restrictions on third-party app access
- Contact Whathead support to check if your region is supported
- Ask when support for your region will be available
- If you have access to a Business Manager in a supported region, try connecting with that instead
Publishing Failures
Publishing fails with 'Permission denied'
Publishing fails with 'Permission denied'
- Your Meta connection doesn’t have the required permissions
- Ad account access was revoked
- Ad account is disabled or restricted
- Navigate to Integrations and reconnect your Meta account
- Ensure you grant all required permissions during authentication
- Verify the ad account is active in Facebook Business Manager
- Check that you have advertiser or admin access to the ad account
- If the account is restricted, resolve the restriction in Meta Ads Manager first
Publishing fails with 'Invalid creative'
Publishing fails with 'Invalid creative'
- Image or video doesn’t meet Meta’s specifications
- File is corrupted or in an unsupported format
- File size exceeds limits
- Check image requirements: JPG/PNG, under 30 MB, at least 600×600 pixels
- Check video requirements: MP4/MOV, under 4 GB, under 241 minutes
- Verify the file is not corrupted by opening it locally
- If using a video, ensure it has valid codec and container format
- Try uploading a different file to isolate the issue
- Re-export the creative from your design tool with correct specifications
Publishing fails with 'Budget below minimum'
Publishing fails with 'Budget below minimum'
- Budget is set below Meta’s $1/day minimum
- Budget field is empty or zero
- Open the campaign or ad set with the budget error
- Set the daily budget to at least $1
- If using lifetime budget, ensure it’s at least $1 total
- Save changes and try publishing again
Publishing fails with 'Multiple objectives' error
Publishing fails with 'Multiple objectives' error
- You’ve connected multiple campaigns with different objectives to one ad set node
- Ad set is trying to inherit conflicting optimization goals
- Review your campaign structure on the canvas
- Identify which campaigns are connected to the same ad set
- Either:
- Create separate ad sets for each campaign, OR
- Ensure all campaigns connected to the ad set have the same objective
- Disconnect incompatible campaigns from the ad set
- Try publishing again
Some campaigns published, others failed
Some campaigns published, others failed
- Some campaigns had validation errors, others didn’t
- Network issues during publishing
- Meta API rate limiting
- Review error messages for failed campaigns
- Fix validation errors on failed campaigns
- Select only the failed campaigns
- Click Publish again — successful campaigns will be skipped automatically
- Verify all campaigns appear in Meta Ads Manager
Publishing is very slow or times out
Publishing is very slow or times out
- Large campaign with many entities
- Slow internet connection
- Meta API is experiencing delays
- Uploading large video files
- Check your internet connection speed
- Try publishing during off-peak hours (avoid weekday mornings)
- If uploading videos, compress them or upload to Meta’s media library first
- Break very large campaigns into smaller batches
- Be patient — campaigns with 50+ entities can take several minutes
- If timeout persists, contact Whathead support
Validation Errors
Error: 'Campaign name is required'
Error: 'Campaign name is required'
- Open the campaign node
- Enter a descriptive name for the campaign
- Save and try publishing again
Error: 'Ad set must have targeting configured'
Error: 'Ad set must have targeting configured'
- Open the ad set node
- Navigate to the Targeting section
- Configure at least one targeting option (age, gender, location, or interests)
- Save and try publishing again
Error: 'Ad must have creative'
Error: 'Ad must have creative'
- Open the ad node
- Click Add Creative or Select Image/Video
- Choose an asset from your media library or upload a new one
- Save and try publishing again
Error: 'Ad set must be connected to a campaign'
Error: 'Ad set must be connected to a campaign'
- On the canvas, locate the disconnected ad set node
- Drag a connection from a campaign node to the ad set node
- Verify the connection is established (line appears between nodes)
- Try publishing again
Error: 'Optimization goal is required'
Error: 'Optimization goal is required'
- Open the ad set node
- Navigate to the Optimization section
- Select an optimization goal compatible with your campaign objective
- Save and try publishing again
Editing Issues
Cannot change campaign objective
Cannot change campaign objective
- Create a new campaign with the desired objective
- Copy your ad sets and ads to the new campaign
- Publish the new campaign
- Pause or archive the old campaign
Cannot change conversion location
Cannot change conversion location
- Create a new ad set with the correct conversion location
- Copy your ads to the new ad set
- Publish the new ad set
- Pause the old ad set
Changes didn't update on Meta
Changes didn't update on Meta
- Changes weren’t saved before publishing
- Publishing failed silently
- Meta Ads Manager cache hasn’t refreshed
- Verify you clicked Save after making changes
- Check the publishing results for any error messages
- Refresh Meta Ads Manager (hard refresh with Cmd+Shift+R or Ctrl+Shift+R)
- Wait a few minutes for Meta’s cache to update
- If changes still don’t appear, try republishing from Whathead
Bulk edit didn't apply to all selected entities
Bulk edit didn't apply to all selected entities
- Some entities don’t support the field you’re editing
- Some entities are locked (e.g., archived campaigns)
- Validation failed for some entities
- Check which entities were updated and which weren’t
- Verify all selected entities support the field you’re editing
- Check for validation errors on entities that didn’t update
- Edit incompatible entities individually
Asset and Creative Issues
Cannot upload image to media library
Cannot upload image to media library
- Image doesn’t meet Meta’s requirements
- File is corrupted
- Network connection issue
- Verify image is JPG or PNG format
- Check file size is under 30 MB
- Ensure resolution is at least 600×600 pixels
- Try opening the image locally to verify it’s not corrupted
- Try uploading a different image to isolate the issue
- Check your internet connection
Cannot upload video to media library
Cannot upload video to media library
- Video doesn’t meet Meta’s requirements
- File size is too large
- Slow internet connection
- Verify video is MP4 or MOV format
- Check file size is under 4 GB
- Ensure duration is under 241 minutes
- Compress the video if it’s very large
- Try uploading during off-peak hours
- Use a wired connection instead of Wi-Fi for large files
Asset appears in media library but cannot be selected
Asset appears in media library but cannot be selected
- Asset is in a different ad account
- Asset failed Meta’s review
- Asset is archived or deleted
- Verify you’re viewing the correct ad account’s media library
- Check the asset’s status in Meta Ads Manager
- If asset failed review, check Meta’s policy violation notice
- Try uploading the asset again if it’s unavailable
Performance and Learning Phase
Ad set stuck in learning phase
Ad set stuck in learning phase
- Be patient — learning can take 7-14 days for new ad sets
- Avoid making changes during learning (resets the phase)
- Ensure budget is sufficient to generate conversions
- If learning persists beyond 2 weeks, consider increasing budget or broadening targeting
Performance dropped after editing
Performance dropped after editing
- Changes reset the learning phase
- New targeting is less effective
- Budget change disrupted delivery
- Wait 3-7 days for performance to stabilize
- Check if ad set re-entered learning phase
- Review what changed and consider reverting if performance doesn’t recover
- Make smaller, incremental changes in the future
Getting More Help
If you’ve tried the troubleshooting steps above and still have issues:- Check Meta’s Status: Visit Meta for Developers Status to see if there are platform-wide issues
- Review Meta’s Documentation: Check Meta’s Business Help Center for platform-specific guidance
- Contact Whathead Support: Reach out with:
- Description of the issue
- Error messages (screenshots helpful)
- Steps you’ve already tried
- Campaign or ad account ID if relevant