Skip to main content

Facebook & Instagram Troubleshooting

Because Instagram requires a connection to a Facebook Page to function within Mixpost, this section applies to anyone looking to utilize both Facebook Pages and Instagram business or creator accounts.

Instagram profiles or Facebook pages are not appearing

  1. Check if you gave consent to all pages and Instagram profiles when you connected your Facebook account.
  2. Verify whether your Instagram account is set up as a business account.
  3. Check if your Instagram account is linked to a Facebook page.

Instagram images or videos not uploading

Instagram API requires media files to be publicly accessible.

Possible causes for your domain no being publicly accessible:

  • Your domain is not publicly accessible (e.g., your instance is running on localhost)
  • You are using Cloudflare authentication. To ensure proper functionality, apply the Zero Trust login to the public UI routes of Mixpost, rather than the entire domain. For example, configure it for example.com/<MIXPOST_CORE_PATH>, allowing uploaded media files (e.g., images, videos, etc.) to be served without requiring login.

Permanently disconnecting a Facebook Account from Mixpost

  1. Go to Facebook Business Tools Settings
  2. Locate your app in the list and click the Remove button.

Disabling the Engagement webhooks

The Engagement feature receives Facebook and Instagram comments through Meta webhooks, controlled by the Enable Webhooks switch in the Facebook service settings.

To disable them from the command line — for example, when migrating domains or decommissioning your Facebook app — run:

php artisan mixpost:disable-facebook-webhooks

This removes the app-level Meta webhook subscriptions, stops Engagement from receiving new comments for every connected account, and turns the Enable Webhooks switch off. You'll be asked to confirm before anything changes.

note

Instagram comments are delivered through the connected account's linked Facebook Page, so this command disables webhooks for both Facebook and Instagram accounts.

Removing per-page subscriptions

Removing the app-level subscription is enough to stop all delivery. Each connected account's per-page subscription stays in place (inactive) and resumes automatically if you re-enable webhooks later. To remove those as well — a full reset — add the --purge-pages option:

php artisan mixpost:disable-facebook-webhooks --purge-pages

To turn webhooks back on, re-enable the Enable Webhooks switch in the Facebook service settings.