Publish content, moderate comments, monitor hashtags, and send messages via the Instagram Graph API — 7 resources, 18 operations.
Authentication: All operations use a Meta OAuth2 AccessToken. You can provide it via a saved credential (
CredentialId) or pass the token string directly (AccessToken). Use auth/tokenExchange to obtain a token from an OAuth code, or auth/tokenRefresh to upgrade to a long-lived token.
Requirements: The Instagram Graph API requires your account to be a Business or Creator account connected to a Facebook Page. Personal Instagram accounts are not supported.
What is the Instagram Node?
The Instagram node connects BizFirst workflows to the Instagram Graph API, enabling automated content publishing, comment management, hashtag monitoring, and direct messaging — all without manual intervention in the Instagram app.
Use it to build content calendars, moderation pipelines, creator engagement tools, and social listening workflows.
Resources & Operations — 18 Total
| Resource | Operation | Description |
|---|---|---|
| auth (3 operations) | ||
auth | tokenExchange | Exchange an OAuth authorization code for an access token. |
auth | tokenRefresh | Convert a short-lived token to a long-lived (60-day) token. |
auth | me | Retrieve the account details (ID, username, account type) for the current access token. |
| media (4 operations) | ||
media | imagePublish | Create and publish a single image post with an optional caption and location tag. |
media | reelsPublish | Publish a Reel video with optional caption and cover image. |
media | storiesPublish | Publish an image or video Story (visible for 24 hours). |
media | carouselPublish | Create a carousel post with up to 10 images. |
| comments (5 operations) | ||
comments | list | Retrieve comments on a specific media post. |
comments | hide | Show or hide a specific comment on your post. |
comments | delete | Permanently delete a comment from your post. |
comments | privateReply | Send a private DM reply to a user who commented on your post. |
comments | toggle | Enable or disable all comments on a post. |
| hashtag (2 operations) | ||
hashtag | search | Look up a hashtag by name to retrieve its hashtagId for use in media queries. |
hashtag | media | Retrieve top or recent posts using a specific hashtag. |
| messaging (1 operation) | ||
messaging | send | Send a direct message to a user via Instagram Messaging. |
| user (2 operations) | ||
user | get | Get public profile information for a user by user ID. |
user | media | Retrieve a paginated list of media posts for a user. |
| page (1 operation) | ||
page | account | Get the connected Facebook Page information for the Instagram account. |
Authentication
| Property | Details |
|---|---|
| Auth method | Meta OAuth2 access token passed with every API request. |
| Where to get it | Use auth/tokenExchange to swap an OAuth code for a token, then auth/tokenRefresh to get a long-lived 60-day token. Store it in BizFirst Credentials Manager. |
| Node property | AccessToken (direct string) or CredentialId (saved credential reference) — required on every operation. |
| Account type | Business or Creator Instagram account connected to a Facebook Page is required for all Graph API features. |
Use Cases
- Auto-post scheduling — trigger image, Reel, or carousel publishing from a ScheduledTrigger or product launch workflow
- Comment moderation — automatically hide or delete spam comments matching keyword patterns
- Hashtag monitoring — monitor branded hashtags and save new posts to a CRM or database for UGC tracking
- Creator tools — reply to commenter DMs with personalised voucher codes or follow-up messages
- Content analytics — collect post metrics and comments into a data pipeline for reporting
In This Guide
Configuration
Complete property reference for all 18 operations across 7 resources, with Required/Optional badges.
Input & Output
Media object schema, comment object, user profile response, and error port details.
Examples
Five examples: auto-publish on launch, hashtag monitoring, spam moderation, DM vouchers, and carousel posts.