Overview
Instagram Graph API (Meta) covers posts, stories, media, comments, insights for business accounts. The Automize Instagram connector covers these. Requires linked Facebook Page (Instagram Business).
- Regions: Global.
- Plans: Free API, Business / Creator accounts only.
Setting up the connection
Auth type: OAuth 2.0 (Authorization Code).
- Instagram account must be a Business or Creator account, linked to a Facebook Page.
- Meta Developers → create app → Instagram Graph API.
- OAuth scopes: instagram_basic, instagram_content_publish, instagram_manage_insights.
- In Automize → Settings → Connectors → Instagram. Paste credentials.
Find your credentials at https://developers.facebook.com/.
Rate limits
200 calls/hour/user (default).
Data model
Instagram primitives:
Business Account ─┬─ Media (posts + reels + stories)
├─ Comments
└─ InsightsAvailable operations
8 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create Media Container | General | Create a media container for publishing |
| Get Insights | General | Get account-level insights/analytics |
| Get Media | General | Get a single media object by ID |
| Get Profile | General | Get the authenticated user profile |
| List Comments | General | List comments on a media object |
| List Media | General | List media for the authenticated user |
| Publish Media | General | Publish a previously created container |
| Reply to Comment | General | Reply to a comment |
Operations
Create Media Container
Create a media container for publishing
| Parameter | Required | Type | Description |
|---|---|---|---|
Image Url image_url | Yes | text | |
Caption caption | Yes | text | |
Media Type media_type | Yes | text |
Get Insights
Get account-level insights/analytics
No input parameters.
Tips
- Reach, impressions, engagement, saved.
Get Media
Get a single media object by ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Media Id media_id | Yes | text |
Get Profile
Get the authenticated user profile
No input parameters.
List Comments
List comments on a media object
| Parameter | Required | Type | Description |
|---|---|---|---|
Media Id media_id | Yes | text |
Tips
- Per post. Moderation + engagement.
List Media
List media for the authenticated user
No input parameters.
Tips
- Recent posts. Filter by media_type (IMAGE, VIDEO, CAROUSEL_ALBUM, REELS).
Publish Media
Publish a previously created container
| Parameter | Required | Type | Description |
|---|---|---|---|
Creation Id creation_id | Yes | text |
Tips
- Two-step: create container → publish.
Reply to Comment
Reply to a comment
| Parameter | Required | Type | Description |
|---|---|---|---|
Message message | Yes | text | |
Comment Id comment_id | Yes | text |
FAQ
- Personal accounts?
- API limited to Business + Creator accounts. Personal accounts: basic read-only via Instagram Basic Display API.