Tools

Instagram

Learn how to use Instagram with Composio

Overview

Enum

INSTAGRAM

Description

Instagram is a social media platform for sharing photos, videos, and stories.

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
string
scopes
string
access_token
string
token
stringRequired

Actions

Create a draft media container for photos/videos/reels before publishing.

Action Parameters

caption
string
content_type
string
cover_url
string
graph_api_version
stringDefaults to v21.0
ig_user_id
stringRequired
image_url
string
is_carousel_item
boolean
media_type
string
video_url
string

Action Response

data
object
error
string
successful
boolean
Publish a draft media container to instagram (final publishing step).

Action Parameters

creation_id
stringRequired
graph_api_version
stringDefaults to v21.0
ig_user_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Get details about a specific instagram dm conversation (participants, etc).

Action Parameters

conversation_id
stringRequired
graph_api_version
stringDefaults to v21.0

Action Response

data
object
error
string
successful
boolean
Get comments on an instagram post.

Action Parameters

after
string
graph_api_version
stringDefaults to v21.0
ig_post_id
stringRequired
limit
integerDefaults to 25

Action Response

data
array
error
string
paging
object
successful
boolean
summary
object
Get instagram post insights/analytics (impressions, reach, engagement, etc.).

Action Parameters

graph_api_version
stringDefaults to v21.0
ig_post_id
stringRequired
metric
array

Action Response

data
array
error
string
paging
object
successful
boolean
Check the processing status of a draft post container.

Action Parameters

creation_id
stringRequired
graph_api_version
stringDefaults to v21.0

Action Response

data
object
error
string
successful
boolean
Get instagram user info including profile details and statistics.

Action Parameters

graph_api_version
stringDefaults to v21.0
ig_user_id
string

Action Response

data
object
error
string
successful
boolean
Get instagram account-level insights/analytics (profile views, reach, impressions, etc.).

Action Parameters

graph_api_version
stringDefaults to v21.0
ig_user_id
string
metric
array
period
stringDefaults to day
since
string
until
string

Action Response

data
array
error
string
paging
object
successful
boolean
Get instagram user's media (posts, photos, videos).

Action Parameters

after
string
graph_api_version
stringDefaults to v21.0
ig_user_id
string
limit
integerDefaults to 25

Action Response

data
array
error
string
paging
object
successful
boolean
List all instagram dm conversations for the authenticated user.

Action Parameters

after
string
graph_api_version
stringDefaults to v21.0
ig_user_id
string
limit
integerDefaults to 25

Action Response

data
array
error
string
paging
object
successful
boolean
List all messages from a specific instagram dm conversation.

Action Parameters

after
string
conversation_id
stringRequired
graph_api_version
stringDefaults to v21.0
limit
integerDefaults to 25

Action Response

data
array
error
string
paging
object
successful
boolean
Mark instagram dm messages as read/seen for a specific user.

Action Parameters

graph_api_version
stringDefaults to v21.0
recipient_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Reply to a comment on instagram media.

Action Parameters

graph_api_version
stringDefaults to v21.0
ig_comment_id
stringRequired
message
stringRequired

Action Response

data
object
error
string
successful
boolean
Send an image via instagram dm to a specific user.

Action Parameters

caption
string
graph_api_version
stringDefaults to v21.0
image_url
stringRequired
recipient_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Send a text message to an instagram user via dm.

Action Parameters

graph_api_version
stringDefaults to v21.0
ig_user_id
string
recipient_id
stringRequired
reply_to_message_id
string
text
stringRequired

Action Response

data
object
error
string
successful
boolean