Publish content and manage an Instagram professional account
OAuth49 native toolsIcon needs-review
This catalogue entry describes the current repository definition. Availability, scopes, and production readiness should be confirmed during private-beta onboarding.
Native tools
GET
instagram_get_profile
Get the connected Instagram professional account profile
/{ig_user_id}
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_user_info
Get Instagram professional account information
/{ig_user_id}
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_list_media
List media published by an Instagram professional account
/{ig_user_id}/media
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_ig_user_media
List the connected Instagram account's media
/{ig_user_id}/media
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_media
Get one Instagram media object by ID
/{media_id}
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_media_children
Get child media objects in an Instagram carousel
/{media_id}/children
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
POST
instagram_create_media_container
Prepare an Instagram image, video, reel, story, or carousel
/{ig_user_id}/media
9 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| image_url | string | optional | Publicly accessible image URL |
| video_url | string | optional | Publicly accessible video URL |
| media_type | string | optional | Container type |
| caption | string | optional | Caption |
| children | string | optional | Comma-separated child container IDs |
| location_id | string | optional | Instagram location ID |
| user_tags | array | optional | Tagged users and positions |
| share_to_feed | boolean | optional | Whether a story is shared to the feed |
POST
instagram_create_carousel_container
Create an Instagram carousel from child containers
/{ig_user_id}/media
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| children | string | required | Comma-separated child container IDs |
| caption | string | optional | Caption |
POST
instagram_publish_media
Publish a previously created Instagram media container
/{ig_user_id}/media_publish
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| creation_id | string | required | Media container ID |
GET
instagram_get_container_status
Check whether an Instagram media container is ready
/{container_id}
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| container_id | string | required | Media container ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_media_comments
List comments on an Instagram media object
/{media_id}/comments
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
POST
instagram_post_media_comments
Create a comment on an Instagram media object
/{media_id}/comments
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| message | string | required | Comment text |
DELETE
instagram_delete_comment
Delete an Instagram comment
/{comment_id}
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| comment_id | string | required | Instagram comment ID |
GET
instagram_get_comment_replies
List replies to an Instagram comment
/{comment_id}/replies
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| comment_id | string | required | Instagram comment ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
POST
instagram_post_comment_replies
Reply to an Instagram comment
/{comment_id}/replies
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| comment_id | string | required | Instagram comment ID |
| message | string | required | Reply text |
GET
instagram_get_media_insights
Retrieve insights for an Instagram media object
/{media_id}/insights
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| metric | string | required | Comma-separated insight metrics |
GET
instagram_get_user_insights
Retrieve account-level Instagram insights
/{ig_user_id}/insights
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| metric | string | required | Comma-separated insight metrics |
| period | string | required | Insight period |
| since | string | optional | Unix timestamp lower bound |
| until | string | optional | Unix timestamp upper bound |
GET
instagram_get_content_publishing_limit
Get current Instagram content publishing usage
/{ig_user_id}/content_publishing_limit
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
GET
instagram_get_user_stories
List active Instagram stories
/{ig_user_id}/stories
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_user_live_media
List live media for an Instagram professional account
/{ig_user_id}/live_media
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_user_tags
List media where the Instagram account is tagged
/{ig_user_id}/tags
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_list_all_conversations
List Instagram Direct conversations
/{ig_user_id}/conversations
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| platform | string | optional | Messaging platform |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_page_conversations
List Instagram conversations associated with a connected Page
/{ig_user_id}/conversations
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| platform | string | optional | Messaging platform |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_conversation
Get an Instagram Direct conversation
/{conversation_id}
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | required | Instagram conversation ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_list_all_messages
List messages in an Instagram Direct conversation
/{conversation_id}/messages
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | required | Instagram conversation ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
POST
instagram_send_text_message
Send a text message in Instagram Direct
/{ig_user_id}/messages
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| recipient | object | required | Recipient object containing the Instagram user ID |
| message | object | required | Text message payload |
POST
instagram_send_image
Send an image message in Instagram Direct
/{ig_user_id}/messages
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| recipient | object | required | Recipient object containing the Instagram user ID |
| message | object | required | Image message payload |
POST
instagram_mark_seen
Mark Instagram Direct messages as seen
/{ig_user_id}/messages
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| recipient | object | required | Recipient object containing the Instagram user ID |
| sender_action | string | required | Provider sender action |
GET
instagram_get_messenger_profile
Get Instagram messaging profile settings
/{ig_user_id}/messenger_profile
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Profile fields |
POST
instagram_update_messenger_profile
Update Instagram messaging profile settings
/{ig_user_id}/messenger_profile
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| profile | object | required | Messenger profile fields |
DELETE
instagram_delete_messenger_profile
Delete Instagram messaging profile settings
/{ig_user_id}/messenger_profile
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Profile fields to remove |
POST
instagram_create_post
Prepare an Instagram image, video, reel, story, or carousel
/{ig_user_id}/media
9 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| image_url | string | optional | Publicly accessible image URL |
| video_url | string | optional | Publicly accessible video URL |
| media_type | string | optional | Container type |
| caption | string | optional | Caption |
| children | string | optional | Comma-separated child container IDs |
| location_id | string | optional | Instagram location ID |
| user_tags | array | optional | Tagged users and positions |
| share_to_feed | boolean | optional | Whether a story is shared to the feed |
POST
instagram_post_ig_user_media
Prepare an Instagram image, video, reel, story, or carousel
/{ig_user_id}/media
9 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| image_url | string | optional | Publicly accessible image URL |
| video_url | string | optional | Publicly accessible video URL |
| media_type | string | optional | Container type |
| caption | string | optional | Caption |
| children | string | optional | Comma-separated child container IDs |
| location_id | string | optional | Instagram location ID |
| user_tags | array | optional | Tagged users and positions |
| share_to_feed | boolean | optional | Whether a story is shared to the feed |
POST
instagram_publish_ig_user_media
Publish a previously created Instagram media container
/{ig_user_id}/media_publish
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| creation_id | string | required | Media container ID |
GET
instagram_get_instagram_media
Get one Instagram media object by ID
/{media_id}
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_ig_media_children
Get child media objects in an Instagram carousel
/{media_id}/children
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_user_media
List media published by an Instagram professional account
/{ig_user_id}/media
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_ig_media_comments
List comments on an Instagram media object
/{media_id}/comments
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_post_comments
List comments on an Instagram media object
/{media_id}/comments
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_ig_comment_replies
List replies to an Instagram comment
/{comment_id}/replies
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| comment_id | string | required | Instagram comment ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
POST
instagram_post_ig_comment_replies
Reply to an Instagram comment
/{comment_id}/replies
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| comment_id | string | required | Instagram comment ID |
| message | string | required | Reply text |
POST
instagram_reply_to_comment
Reply to an Instagram comment
/{comment_id}/replies
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| comment_id | string | required | Instagram comment ID |
| message | string | required | Reply text |
GET
instagram_get_ig_media_insights
Retrieve insights for an Instagram media object
/{media_id}/insights
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| metric | string | required | Comma-separated insight metrics |
GET
instagram_get_post_insights
Retrieve insights for an Instagram media object
/{media_id}/insights
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| media_id | string | required | Instagram media ID |
| metric | string | required | Comma-separated insight metrics |
GET
instagram_get_ig_user_content_publishing_limit
Get current Instagram content publishing usage
/{ig_user_id}/content_publishing_limit
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
GET
instagram_get_ig_user_stories
List active Instagram stories
/{ig_user_id}/stories
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_ig_user_live_media
List live media for an Instagram professional account
/{ig_user_id}/live_media
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_ig_user_tags
List media where the Instagram account is tagged
/{ig_user_id}/tags
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| ig_user_id | string | required | Instagram professional account ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
instagram_get_post_status
Check whether an Instagram media container is ready
/{container_id}
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| container_id | string | required | Media container ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |