Instagram Node
Connect BizFirstAI workflows to the Instagram Graph API. Publish media, moderate comments, query user profiles, search hashtags, send direct messages, and process real-time webhook events — all from a single authenticated node.
Overview
The Instagram node integrates with the Meta Graph API v18.0+ using a long-lived user or page access token. It supports Instagram Business and Creator accounts. All operations are authenticated via an access token stored in the BizFirst Credentials Manager — no raw secrets are stored in workflow configuration.
Business or Creator account required: The Instagram Graph API is available only to Instagram Professional accounts (Business or Creator) connected to a Facebook Page. Personal Instagram accounts cannot use the Graph API.
Authentication
| Field | Required | Description |
|---|---|---|
accessToken | Required | Long-lived user or page access token (60-day expiry). Store in BizFirst Credentials Manager. Obtain via auth/getToken, refresh via auth/refreshToken. |
igUserId | Required | Instagram Business/Creator account ID — a numeric string (e.g. 17841400000000000). Retrieve programmatically via page/get. |
apiVersion | Optional | Graph API version, e.g. v18.0. Defaults to v18.0. |
Token expiry: Long-lived tokens expire after 60 days. Schedule an auth/refreshToken node on a 50-day cron to maintain continuous access. The refresh resets the 60-day window.
Operations
Media
Comment
User
Hashtag
Messaging
Page
Auth
Trigger
Rate Limits
| Endpoint Type | Limit |
|---|---|
| Standard Graph API | 200 calls per user per hour |
| Business Discovery API | 200 calls per user per hour |
| Hashtag search (unique hashtags) | 30 unique hashtags per 7 days per user |
| Hashtag media results per call | Maximum 10 results |
| Token refresh minimum interval | 24 hours between refreshes |
Resource / Operation Reference
| resource | operation | Documentation |
|---|---|---|
ig-user | get | user/get |
ig-user | get-media | user/getMedia |
ig-hashtag | search | hashtag/get |
ig-hashtag | get-recent-media | hashtag/getRecentMedia |
ig-hashtag | get-top-media | hashtag/getTopMedia |
comments | list | comment/getMany |
comments | hide | comment/hide |
comments | unhide | comment/unhide |
comments | delete | comment/delete |
comments | send-private-reply | comment/reply |
messaging | send | messaging/send |
page | get-instagram-account | page/get |
auth | exchange-token | auth/getToken |
auth | refresh-token | auth/refreshToken |
auth | get-me | auth/revokeToken (verify token) |
trigger | receive-event | trigger/webhook |