Connecting Meta: Instagram and Facebook in one flow
Step-by-step guide to connecting your Meta Business account so In-House can publish posts, run ads, and read insights.
To let In-House run organic and paid Meta work, we need access to your Meta Business account. This is one OAuth flow that grants four scopes at once. You only need to do it once per workspace.
Before you start
You need:
- A Facebook page connected to your Instagram business profile
- A Meta Business Manager account (free, takes 2 minutes to set up if you don’t have one)
- Admin role on the Business Manager (not just Editor)
If you’re not the admin, ask the admin to either:
- Make you an admin, or
- Run through this flow themselves while you watch
The OAuth grant has to come from an admin. There’s no way around it.
The four scopes we ask for
In the consent screen, you’ll see four permission groups:
- pages_show_list — see which pages you manage
- pages_manage_posts — create and edit posts on those pages
- instagram_basic + instagram_content_publish — read Instagram insights, publish to Instagram via the connected Facebook page
- ads_management + ads_read — run campaigns, read insights
We never ask for pages_messaging (we don’t reply to DMs on your
behalf), business_management (we don’t change account settings), or
leads_retrieval (we don’t pull lead-form data).
Step-by-step
- From
/settings/integrations, click Connect Meta. - You’ll be redirected to Facebook. Sign in with the account that admins your Business Manager.
- Choose the Business Manager account, then the pages.
- Review the four scopes. All four must be granted for the connection
to work. (If you click “Edit access” and uncheck one, the integration
will land in
auth_status: revokedimmediately.) - Click Allow.
- You’ll be redirected back. The integration card will show
Status: linked, Active.
The first sync runs immediately. You’ll see your last 90 days of Instagram insights populate inside about 4 minutes.
What if you don’t see your page in the list
Two common causes:
- You’re an Editor, not Admin. Ask the admin to redo the flow.
- The page isn’t connected to a Business Manager. Go to Business Settings on Facebook, add the page to your Business account, then retry.
If neither of those is the cause, your account lead can run a debug session with you on a screen share. We can usually spot what’s missing in under 5 minutes.
Disconnecting
You can revoke the connection at any time from /settings/integrations
or directly from Facebook Business Settings. If you revoke from
Facebook, In-House will detect it on the next hourly sync and move the
integration to auth_status: revoked. Any in-flight campaigns will
pause, and you’ll get a notification to reconnect.
We deliberately don’t auto-resume if you reconnect within 24 hours. That’s a safety guard: if you revoked because something went wrong, you probably don’t want the agents to immediately keep going.
What we do with the data
- Insights data is stored in your workspace’s row in
external_sources. - We use it to inform the agents (best-performing post times, audience profile, ad performance) and to power the dashboards you see.
- We never sell it, never share it with other tenants, and never use it to train models that benefit other businesses.
When you delete your workspace, we hard-delete all of it inside 30 days.
Reply to your account lead from inside In-House if you spot something missing. We update guides every fortnight.