Last updated 2026-06-14
What this unlocks
Connect Instagram and Quri reads your organic profile and media metrics — reach, engagement, and account insights — separate from the paid spend that comes through Meta Ads, so you see how your unpaid posts are doing alongside everything else.
Connect it in Quri
- Instagram does not have a self-serve tile on /app/connect yet, so this is an operator-assisted connection today rather than a one-click grant — the connector and its OAuth flow exist, but the in-app button does not.
- Make sure the Instagram account is a Business or Creator (professional) account — personal accounts can no longer be read by any third-party API since the Basic Display API ended.
- Reach out so a Quri operator can run the Instagram authorization for your workspace; the grant is then stored as encrypted, workspace-scoped credentials.
- After the first sync, your organic Instagram metrics appear in Quri, and Quri refreshes the long-lived token for you to keep the connection alive.
Get your credentials
- Convert the Instagram account to a Business or Creator account in the Instagram app under Settings if it is still a personal account — this is required for API access.
- In the Meta App Dashboard at developers.facebook.com, add the Instagram product so the app can request Instagram Login.
- Configure the Instagram Login redirect URI for the app, then submit for App Review to request the read permissions below for accounts outside your own.
- Quri uses the Instagram Login flow (instagram.com/oauth/authorize) and exchanges the code for a long-lived token, which it then refreshes — no manual token rotation is needed once connected.
Access Quri reads with
- instagram_business_basic — read the connected account's profile and media.
- instagram_business_manage_insights — read the account's own organic insights (reach, engagement, and similar metrics).
- These are read scopes for a professional account's own data; Quri does not post, comment, or send messages on your behalf.
Troubleshooting
- The authorization fails or my account is not accepted.
- Confirm the account is a Business or Creator account. Since the Instagram Basic Display API reached end-of-life in December 2024, personal accounts can no longer be connected — switching to a professional account in the Instagram app settings resolves this.
- Why is Instagram listed separately from Meta Ads if they are both Meta?
- Meta Ads gives Quri your paid ad-account spend and creatives, while the Instagram connection gives organic profile and media metrics. They use different permissions and different data, so they are connected separately even though both run through Meta.
- My Instagram metrics stopped updating after a while.
- Instagram tokens are long-lived but expire if not refreshed, and they are also revoked if you remove Quri in your Meta app settings or switch the account back to personal. Reconnecting through the operator-assisted flow issues a fresh token.