Connecting Instagram Organic on Clarisights
Connect your Instagram Business or Creator accounts to Clarisights to track organic profile growth, post and reel reach, story engagement, saves, and audience reach — all alongside your paid channels. Use it to measure how organic content drives discovery, follower growth, and downstream conversions.
At a glance
| Authentication | OAuth 2.0 (Facebook Login — Instagram accounts must be linked to a Facebook Page) |
| Permissions needed | instagram_basic, instagram_manage_insights, pages_show_list, pages_read_engagement |
| Account discovery | Automatic — every Instagram Business / Creator account linked to your Facebook Pages is offered |
| Data freshness | Daily |
| Lookback window | 30 days per ingestion split (Instagram Insights API limit) |
| Backfill on connect | Configured per company; default backfill aligns with the standard organic ingestion window |
| Timezone | UTC |
| Currency | Not applicable (organic data is non-monetary) |
| Levels supported | Account (IG Profile) · Campaign (Post / Reel / Story / Carousel) · Account Segment |
| Limited rollout | No |
Prerequisites
An Instagram Business or Instagram Creator account — personal Instagram accounts cannot connect.
The Instagram account must be linked to a Facebook Page. Insights are accessed via the Page’s
instagram_business_accountconnection.A Facebook user with an Admin / Editor / Analyst role on the linked Facebook Page.
At least 100 followers for full demographics and account-segment data — Instagram suppresses some breakdowns below this threshold.
Permission to authorize third-party apps on your Facebook profile.
Steps to Connect
Step 1 — Sign in with Facebook from Clarisights
In Clarisights, go to Integrations → Organic Channels → Instagram Organic and click Connect. You will be redirected to Facebook Login — Instagram organic auth runs through the same OAuth flow because Instagram Insights are exposed via the Facebook Graph API.
[TODO: Screenshot needed — Integrations page Instagram Organic row with Connect button]
Step 2 — Authorize Clarisights
Facebook will display a permission screen listing the Instagram and Page permissions Clarisights requires. On the Page selection screen, choose every Facebook Page that has a linked Instagram account — deselected Pages cannot be connected later without re-running OAuth. Click Continue to grant access.
⚠ Common error: "No Instagram accounts available." → The selected Pages don’t have a linked Instagram Business / Creator account. Open Facebook Page Settings → Linked Accounts on each Page and link the Instagram account first, then re-run the connect flow.
⚠ Common error: "Personal Instagram accounts can’t be connected." → Convert the account to a Business or Creator profile from Instagram’s Settings → Account → Account Type, then re-run OAuth.
Step 3 — Select the Instagram accounts to onboard
After authorization, Clarisights discovers every Instagram Business / Creator account linked to the Facebook Pages you authorized. Pick the profiles you want to connect, optionally rename them, and click Create Accounts.
Verify the connection
Go to Integrations → Instagram Organic. Each connected profile should show a Connected status with the IG account ID and username populated.
First data appears within ~24 hours of the next scheduled sync.
Quick start: create a new report, add Instagram Organic as the data source, and pull Account (IG Profile) · Campaign (Post) · IGO Impressions · IGO Engagement · IGO Followers Count.
Data available
Hierarchy
Instagram Organic uses an Account (IG Profile) → Campaign (Media object) hierarchy. Clarisights aliases Instagram’s native objects to its standard levels for cross-channel reporting:
Native level (Instagram) | Clarisights level |
Instagram Business / Creator account (Profile) | Account |
Media (Post / Reel / Story / Carousel Album) | Campaign |
Audience demographic breakdown (followers over time) | Account Segment |
There is no Ad Group or Ad level — Instagram Organic is a two-level integration plus account-segment breakdowns.
Dimensions
Dimension | Level | Description |
Account / Account ID | Account | Instagram Business Account display name and ID |
Username | Account | Instagram handle |
Post / Post ID | Campaign | Media caption preview and Instagram media ID |
Caption | Campaign | Full media caption |
Permalink | Campaign | Direct link to the post on Instagram |
Media Type | Campaign | IMAGE, VIDEO, CAROUSEL_ALBUM, or STORY |
Media Product Type | Campaign | FEED, STORY, REELS, IGTV — disambiguates Reels from standard Feed video |
Timestamp | Campaign | Media publish timestamp |
Followers Demographic Breakdown | Account Segment | Time-series follower additions tracked at the account level |
Metrics
Account / profile metrics
Metric | Description |
IGO Followers Count | Total followers on the day of pull |
IGO Followers Count Lifetime | Cumulative followers over the lifetime of the profile |
IGO Follower Count | New followers added in the period (delta) |
IGO Impressions | Total impressions across all profile content |
IGO Views | Profile views in the period |
Post performance (Campaign level, all media types)
Metric | Description |
IGO Impressions / Impressions Lifetime | Total impressions on a media object (period and lifetime) |
IGO Posts Like Count / Lifetime | Total likes on a post |
IGO Posts Comments Count / Lifetime | Total comments on a post |
IGO Engagement / Engagement Lifetime | Total engagement on Image / Video / Carousel media (likes + comments + saves) |
IGO Saved / Saved Lifetime | Times the media was saved |
IGO Reach / Reach Lifetime | Unique accounts reached (Stories) |
Video (Reels & Feed video)
Metric | Description |
IGO Video Views / Video Views Lifetime | Total video views on a Reel or video post |
Carousel album
Metric | Description |
IGO Carousel Album Impressions / Lifetime | Impressions on a carousel post |
IGO Carousel Album Engagement / Lifetime | Engagement on a carousel post |
IGO Carousel Album Video Views / Lifetime | Video views on the video card(s) of a carousel |
Story (Campaign level, STORY media)
Metric | Description |
IGO Reach / Lifetime | Unique accounts that viewed the story |
IGO Replies / Lifetime | DM replies on the story |
IGO Exits / Lifetime | Times viewers exited the story |
IGO Taps Forward / Lifetime | Forward taps to next frame |
IGO Taps Back / Lifetime | Back taps to previous frame |
Account Segment metrics
Metric | Description |
IGO Instagram Followers Lifetime | Followers tracked over time |
IGO Instagram Followers New | New followers within the segment / period |
IGO Unique Activity | Unique engagement events |
Limitations & known constraints
Business / Creator accounts only: Personal Instagram accounts cannot be connected. Convert the account first.
Linked Page required: Insights are pulled via Facebook Graph API; the Instagram account must be linked to a Facebook Page.
30-day query window: Instagram Insights API caps each query at 30 days. Clarisights ingests in 30-day splits — long historical pulls run as multiple sequential jobs.
Time-capped metrics:
follower_countis only available for the last 30 days. Historical follower deltas before that window are not retrievable.90-day storage cap (User Metrics): Some user-level insights are stored for only 90 days upstream. Older datapoints cannot be backfilled.
100-follower minimum: Audience demographic breakdowns (Account Segment) are suppressed for profiles below 100 followers.
v21 deprecations (Jan 2025+): Meta deprecated
video_viewsfor non-Reels media,profile_viewstime-series,website_clicks,phone_call_clicks, andtext_message_clicks. Affected metrics will be flagged in the Clarisights metric picker as they are removed from the API.Story 24-hour window: Story insights stop updating once the story expires. Pull cadence ensures Clarisights captures pre-expiry values.
Operating notes
Refresh schedule: daily.
Lookback: incremental ingestion in 30-day splits to respect the Instagram Insights API window.
Multi-profile: a single Facebook user can connect every Instagram Business / Creator account linked to its Pages. Re-run OAuth to add new profiles.
Adding new Instagram accounts: link the new Instagram account to a Facebook Page first, then re-open the Instagram Organic integration in Clarisights to discover and add it.
Credential rotation: OAuth tokens refresh automatically. Re-authenticate only if you change your Facebook password, revoke Clarisights from your Business Integrations, or your Page admin role is revoked.
Lifetime vs. period metrics: most engagement metrics are exposed as both period and lifetime variants. Use the lifetime variant for cumulative totals on a post; use the period variant when filtering on a date range.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and Instagram Business Account ID (Integrations → Instagram Organic)
The exact error message or screenshot
The step where the issue occurred
When the issue started