Exchange a short-lived token for a long-lived token (valid ~60 days). Uses platform-specific endpoints: Instagram (graph.instagram.com) or Threads (graph.threads.net). Requires META_APP_SECRET.

Refresh a long-lived token before it expires (must be at least 24h old). Uses platform-specific endpoints: Instagram (graph.instagram.com) or Threads (graph.threads.net). Returns a new long-lived token valid for 60 days.

Debug/inspect an access token to check validity, expiration, scopes and associated user.

Get Meta App basic information (name, category, namespace, etc.).

Subscribe to webhook notifications for an object (e.g., 'instagram', 'page'). Requires META_APP_ID and META_APP_SECRET.

List current webhook subscriptions for the Meta App.

Publish a photo to Instagram. Two-step process: creates container then publishes. Requires image_url (publicly accessible HTTPS URL).

Publish a video to Instagram feed. Waits for video processing before publishing.

Publish a carousel (album) post with 2-10 images/videos. Each item needs an image_url or video_url.

Publish a Reel (short video). Waits for video processing.

Publish a Story (image or video). Stories disappear after 24 hours.

Check the processing status of a media container (useful for videos).

Get list of media published on the Instagram account.

Get details of a specific Instagram media post.

Delete an Instagram media post (posts, carousels, reels, stories). This action is irreversible. Requires instagram_manage_contents permission (Facebook Login only — not available with Instagram Login).

Get insights/analytics for a specific media post. Note: 'impressions' and 'video_views' were deprecated in v22.0 — use 'views' instead. Available metrics: views, reach, saved, shares, likes, comments, reposts, reels_skip_rate.

Enable or disable comments on an Instagram media post.

Get comments on a specific Instagram media post.

Get details of a specific comment.

Post a top-level comment on a media post.

Get replies to a specific comment.

Reply to a specific comment.

Hide or unhide a comment on your post.

Delete a comment from your media post. This action is irreversible.

Get Instagram Business/Creator account profile information.

Get Instagram account insights. Note: 'impressions', 'email_contacts', 'phone_call_clicks', 'text_message_clicks', 'get_directions_clicks', 'website_clicks', 'profile_views' were deprecated in v22.0. Use 'views', 'reach', 'follower_count', 'reposts' instead.

Look up another Instagram Business/Creator account's public info by username.

Get pending collaboration invites for the Instagram account. Added in December 2025.

Accept or decline a collaboration invite. Added in December 2025.

Search for a hashtag ID by name. Required before querying hashtag media. Limited to 30 unique hashtags per 7-day rolling window.

Get hashtag information by ID.

Get recent media tagged with a specific hashtag.

Get top (most popular) media tagged with a specific hashtag.

Get comments where the account was @mentioned. Returns the media and comment details.

Get media where the account is tagged (photo tags, not @mentions).

Get Instagram DM conversations list. Requires 'instagram_business_manage_messages' permission and the Instagram Messaging API.

Get messages in a specific DM conversation.

Send a DM to a user. Requires 'instagram_business_manage_messages' permission. Can only message users who have messaged you first (24hr window).

Get details of a specific DM message.

Publish a text-only post on Threads. By default publishes in a single API call via auto_publish_text=true (faster and avoids the 4279009 'container not propagated' race condition). Supports optional link attachment, poll, GIF, topic tag, quote post, cross-share to Instagram Stories, and text_attachment for long-form content (up to 10,000 chars with optional styling and link). text_attachment cannot be combined with poll_options or link_attachment. Set auto_publish=false to fall back to the legacy two-step create-then-publish flow.

Publish an image post on Threads. Supports topic tag, quote post, alt text, spoiler flag, and cross-share to Instagram Stories.

Publish a video post on Threads. Waits for video processing. Supports topic tag, quote post, alt text, spoiler flag, and cross-share to Instagram Stories. Note: cross-share to IG Stories may silently fail for video posts (the Threads post still publishes).

Publish a carousel post on Threads with 2-20 images/videos. Supports cross-share to Instagram Stories.

Delete a Threads post. This action is irreversible. Rate limited to 100 deletions per 24 hours.

Check the processing status of a Threads media container. Only works with unpublished container IDs (returned from container creation endpoints) — not with published post IDs.

Check how many posts you can still publish within the current 24-hour window (max 250 posts/day).

Repost an existing Threads post to your own profile. Reposts appear under the Reposts tab on your profile. Requires the threads_content_publish permission. Note: this is a simple repost — for quote-reposts use threads_publish_text with quote_post_id.

Get a list of published Threads posts.

Get details of a specific Threads post.

Search for public Threads posts by keyword or topic tag. Requires threads_keyword_search permission.

Get replies for a specific Threads post. By default returns only top-level replies (mode='top_level', endpoint /{post}/replies). Set mode='full_tree' to get the entire conversation flattened — every reply at every nesting level (endpoint /{post}/conversation). Both modes share the same response shape; full_tree additionally populates root_post, replied_to, is_reply so the caller can reconstruct the tree.

Reply to a Threads post or another reply. Text-only replies publish in a single API call by default (auto_publish_text=true); media replies always use the two-step create-then-publish flow.

Hide a reply on your Threads post. Hidden replies are still visible if directly accessed.

Unhide a previously hidden reply on your Threads post.

Get Threads user profile information including verification status.

Get all threads published by the user (alias for threads_get_posts with user context).

Get insights/analytics for a specific Threads post (views, likes, replies, reposts, quotes).

Get account-level Threads insights (views, likes, replies, reposts, quotes, clicks, followers, follower demographics). Requires period parameter.

List Threads posts where the authenticated user has been @mentioned. Requires the threads_manage_mentions permission. Posts from private profiles are excluded by the API. Without advanced access approval, only mentions from designated app testers are returned.