Instagram

Overview

Phinite’s Instagram predefined tool lets workspace assistants call Instagram APIs through DevStudio after you save a connection under Integrations → Predefined tools.

Manage an Instagram Business or Creator account — profile, media publishing, comments, insights, hashtags, stories, and business discovery via the Instagram Graph API.

What this integration enables

Automate workflows using this predefined tool from agent graphs
Connect once under Integrations and reuse across assistants
Enable individual subtools per agent in Graph Studio

Required credentials

Access Token access_token (required)
Instagram User ID ig_user_id (required)

Setup steps

Meta Developers → create app → add Instagram product → configure permissions and obtain access token for your business account.
Log into your Phinite workspace at app.phinite.ai
Navigate to Integrations → Predefined tools
Select Instagram
Click + Add Configuration
Enter the credential fields listed above
Select assistants that should use this connection
Click Save Configuration

Configure in Graph Studio

Open an agent in Graph Studio
Select the agent node → Tools tab → Add a new tool
Choose InstagramTools (or search for Instagram)
Select your saved connection or add a new one
Enable the subtools your workflow needs and save

Predefined tools

Phinite provides 20 subtools for Instagram:

Get Profile: Get the Instagram Business/Creator account profile fields including username, biography, follower count, and media count.
Get User Media: Get a paginated list of media objects published by the Instagram account.
Get Content Publishing Limit: Get the content-publishing rate-limit status for the account (100 posts per 24h quota).
Get Media: Get details of a specific Instagram media object by its ID.
Publish Photo: Publish a photo to the Instagram feed. Image must be a public JPEG URL. Two-step container-then-publish flow.
Publish Reel: Publish a Reel (short video) to Instagram. Video must be a public URL. Two-step container-then-publish flow.
Publish Carousel: Publish a carousel (album) of up to 10 images or videos to Instagram. Each child item must have image_url or video_url.
Delete Media: Delete an Instagram media object (post, story, reel, or carousel). Only works with Instagram API with Facebook Login.
Get Media Comments: Get comments on a specific Instagram media object in reverse chronological order.
Post Comment: Post a new comment on an Instagram media object.
Reply To Comment: Reply to a top-level comment on an Instagram media object.
Hide Comment: Hide or unhide a comment on an Instagram media object. Hidden comments are not visible to other users.
Delete Comment: Delete a comment on an Instagram media object. Only the media owner can delete comments.
Get User Insights: Get insights/metrics for the Instagram Business/Creator account (impressions, reach, profile_views, follower_count, etc.).
Get Media Insights: Get insights/metrics for a specific Instagram media object (engagement, impressions, reach, saved, video_views, etc.).
Discover Business: Get public information about another Instagram Business or Creator account by username.
Search Hashtag: Search for an Instagram hashtag and get its IG Hashtag ID. Max 30 unique hashtag queries per 7-day period.
Get Hashtag Recent Media: Get recent media objects tagged with a specific Instagram hashtag. Requires the hashtag ID (use search_hashtag first).
Get Stories: Get the list of currently live (unexpired) stories for the Instagram account.
Get Container Status: Check the status of a media container during publishing. Status can be EXPIRED, ERROR, FINISHED, IN_PROGRESS, or PUBLISHED.

Documentation & resources

Official documentation: https://developers.facebook.com/docs/instagram-api
Phinite documentation: Instagram

Notes

Store API keys and tokens securely; many providers show secrets only once
Use separate connections for Dev, UAT, and Prod environments where possible
Test with a minimal subtool call after saving credentials