Skip to main content
Threads logo
  • Category: social media accounts
  • Auth: OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 24
  • Triggers: 0
  • Slug: THREADS
  • Version: 20261026_00

Tools

Slug: THREADS_CREATE_AND_SHARE_POSTCreate and publish a top-level Threads post and cross-share it to the linked Instagram account as a Story. Returns crossreshare_to_ig_status to report whether the Story cross-share succeeded independently of Threads publication.

Input Parameters

string
Post or caption text, up to 500 UTF-8 bytes. TEXT posts require this or text_attachment.
string
Threads user ID to publish for; use me for the connected profile.
string
Accessibility description for a single image or video, up to 1,000 characters.
string
Publicly reachable image URL, required when media_type is IMAGE.
string
Topic tag of 1-50 characters; periods and ampersands are not allowed.
string
Publicly reachable video URL, required when media_type is VIDEO.
string ("TEXT" | "IMAGE" | "VIDEO" | "CAROUSEL")
required
Primary post media type.
string
Location ID from THREADS_SEARCH_LOCATIONS.
array
Two to four poll choices of 1-25 characters each; valid only for text posts.
boolean
Whether to attach location_id; set true only when location tagging is intended.
boolean
Create a text ghost post that expires after 24 hours.
string
Threads post ID to quote.
array
Up to 10 spoiler ranges in the post text, each with a type, offset, and length.
Two to twenty image or video items for a CAROUSEL post.
object
Optional GIPHY attachment for a text post.
URL to attach to a text post.
object
Optional long-form text attachment for a text post.
boolean
Blur media as a spoiler until the viewer reveals it.
array
Two-letter ISO country codes allowed to view the post.
boolean
Use dark mode for the Instagram Story cross-share.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_CREATE_POSTCreate and publish a top-level Threads text, image, video, carousel, quote, poll, ghost, GIF, or text-attachment post, optionally with a location tag.

Input Parameters

string
Post or caption text, up to 500 UTF-8 bytes. TEXT posts require this or text_attachment.
string
Threads user ID to publish for; use me for the connected profile.
string
Accessibility description for a single image or video, up to 1,000 characters.
string
Publicly reachable image URL, required when media_type is IMAGE.
string
Topic tag of 1-50 characters; periods and ampersands are not allowed.
string
Publicly reachable video URL, required when media_type is VIDEO.
string ("TEXT" | "IMAGE" | "VIDEO" | "CAROUSEL")
required
Primary post media type.
string
Location ID from THREADS_SEARCH_LOCATIONS.
array
Two to four poll choices of 1-25 characters each; valid only for text posts.
boolean
Whether to attach location_id; set true only when location tagging is intended.
boolean
Create a text ghost post that expires after 24 hours.
string
Threads post ID to quote.
string ("everyone" | "accounts_you_follow" | "mentioned_only" | "parent_post_author_only" | "followers_only")
Who may reply to the new post.
array
Up to 10 spoiler ranges in the post text, each with a type, offset, and length.
Two to twenty image or video items for a CAROUSEL post.
object
Optional GIPHY attachment for a text post.
URL to attach to a text post.
object
Optional long-form text attachment for a text post.
boolean
Blur media as a spoiler until the viewer reveals it.
boolean
Require approval before replies become visible; unsupported for ghost posts.
array
Two-letter ISO country codes allowed to view the post.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_CREATE_REPLYCreate and publish a reply to a Threads post, including a text, image, video, carousel, quote, poll, GIF, or text-attachment reply.

Input Parameters

string
Post or caption text, up to 500 UTF-8 bytes. TEXT posts require this or text_attachment.
string
Threads user ID to publish for; use me for the connected profile.
string
Accessibility description for a single image or video, up to 1,000 characters.
string
Publicly reachable image URL, required when media_type is IMAGE.
string
Topic tag of 1-50 characters; periods and ampersands are not allowed.
string
Publicly reachable video URL, required when media_type is VIDEO.
string ("TEXT" | "IMAGE" | "VIDEO" | "CAROUSEL")
required
Primary post media type.
string
Location ID from THREADS_SEARCH_LOCATIONS.
string
required
Threads post ID that the new post replies to.
array
Two to four poll choices of 1-25 characters each; valid only for text posts.
string ("owned" | "keyword_search" | "mention")
required
How the target post was obtained: owned for the connected user’s content, keyword_search for search results, or mention for posts mentioning the user.
boolean
Whether to attach location_id; set true only when location tagging is intended.
boolean
Create a text ghost post that expires after 24 hours.
string
Threads post ID to quote.
string ("everyone" | "accounts_you_follow" | "mentioned_only" | "parent_post_author_only" | "followers_only")
Who may reply to the new post.
array
Up to 10 spoiler ranges in the post text, each with a type, offset, and length.
Two to twenty image or video items for a CAROUSEL post.
object
Optional GIPHY attachment for a text post.
URL to attach to a text post.
object
Optional long-form text attachment for a text post.
boolean
Blur media as a spoiler until the viewer reveals it.
boolean
Require approval before replies become visible; unsupported for ghost posts.
array
Two-letter ISO country codes allowed to view the post.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_DELETE_POSTPermanently delete a Threads post owned by the connected profile.

Input Parameters

string
required
ID of the owned Threads post to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_GET_LOCATIONRetrieve one Threads location by ID for inspection or post tagging.

Input Parameters

array
Location fields to return from id, name, address, city, country, latitude, longitude, and postal code. Omit to use the provider default.
string
required
Location ID returned by THREADS_SEARCH_LOCATIONS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_GET_MY_PROFILEReturn the connected or app-scoped Threads user’s profile and identity fields.

Input Parameters

array
Profile fields to return from id, username, name, profile picture URL, biography, verification status, geo-gating eligibility, and recently searched keywords. Omit to use the provider default.
string
App-scoped Threads user ID; use me for the connected profile.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_GET_POSTRetrieve one Threads post by ID. Third-party posts may be unavailable until the Meta app has advanced access.

Input Parameters

array
Post fields to return. Defaults to identity, content, media, relationship, location, poll, spoiler, and attachment fields. The unsupported is_repost field is rejected; use media_type and reposted_post instead.
string
required
Threads post ID to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_GET_POST_EMBEDReturn embeddable HTML and oEmbed metadata for a public Threads post.

Input Parameters

string
required
Permanent URL of the public Threads post to embed.
integer
Maximum embed width in pixels, from 320 through 658.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_GET_POST_INSIGHTSReturn selected lifetime engagement metrics for one post owned by the connected Threads profile.

Input Parameters

array
required
One or more lifetime post metrics to return.
string
required
Owned Threads post ID to analyze.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_GET_PROFILE_INSIGHTSReturn one time-window page of selected profile time-series, totals, link clicks, follower counts, or follower demographics for a Threads profile.

Input Parameters

integer
Start of the insight window as a Unix timestamp. Supply together with until. Unsupported for followers_count and follower_demographics.
integer
End of the insight window as a Unix timestamp. Supply together with since. Unsupported for followers_count and follower_demographics.
string
Opaque continuation cursor from next_cursor in a previous response. Pass it back unchanged with the same metrics to fetch the next time window.
array
required
Profile metrics to return. Supported values are views, likes, replies, reposts, quotes, clicks, followers_count, and follower_demographics.
string
App-scoped Threads user ID; use me for the connected profile.
string ("country" | "city" | "age" | "gender")
Demographic dimension. Required exactly when follower_demographics is requested; that metric requires at least 100 followers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_GET_PUBLISHING_LIMITSReturn current usage and configured quota for Threads posts, replies, deletes, location searches, or all publishing categories.

Input Parameters

string
App-scoped Threads user ID; use me for the connected profile.
string ("post" | "reply" | "delete" | "location_search" | "all")
Quota category to return. Selecting all requires the permissions for post publishing, replies, deletion, and location search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_LIST_GHOST_POSTSList active and archived ghost posts created by the connected Threads profile, one cursor page at a time.

Input Parameters

integer
Maximum ghost posts to return in this page.
string
Earliest ghost-post time as a Unix timestamp or provider-supported date string.
string
Latest ghost-post time as a Unix timestamp or provider-supported date string.
string
Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue.
array
Ghost-post fields to return. Defaults to id, text, timestamp, and ghost_post_status.
string
App-scoped Threads user ID; use me for the connected profile.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_LIST_MY_MENTIONSList public Threads posts that mention the connected profile, one cursor page at a time. With development access, Threads may return only mentions made by app testers, so an empty page does not prove that no public mentions exist.

Input Parameters

integer
Maximum mentions to return in this page.
string
Earliest mention time as a Unix timestamp or provider-supported date string.
string
Latest mention time as a Unix timestamp or provider-supported date string.
string
Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue.
array
Mentioned-post fields to return. Defaults to id, text, timestamp, username, and permalink.
string
App-scoped Threads user ID; use me for the connected profile.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_LIST_MY_POSTSList posts created by the connected Threads profile, one cursor page at a time.

Input Parameters

integer
Maximum posts to return in this page.
string
Earliest post time as a Unix timestamp or provider-supported date string.
string
Latest post time as a Unix timestamp or provider-supported date string.
string
Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue.
array
Post fields to return. Defaults to id, text, timestamp, media_type, and permalink.
string
App-scoped Threads user ID; use me for the connected profile.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_LIST_MY_REPLIESList replies created by the connected Threads profile, one cursor page at a time.

Input Parameters

integer
Maximum replies to return in this page.
string
Earliest reply time as a Unix timestamp or provider-supported date string.
string
Latest reply time as a Unix timestamp or provider-supported date string.
string
Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue.
array
Reply fields to return. Defaults to id, text, timestamp, username, and replied_to.
string
App-scoped Threads user ID; use me for the connected profile.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_LIST_PENDING_REPLIESList one page of pending or ignored replies for an owned Threads post. The post must have been created with reply approvals enabled.

Input Parameters

string
Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue.
array
Reply fields to return. Defaults to id, text, timestamp, username, and reply_approval_status.
string
required
Owned Threads post ID that was created with reply approvals enabled.
boolean
Whether to request reverse chronological/order behavior from Threads.
string ("pending" | "ignored")
Restrict results to pending or ignored replies; omit to return both.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_LIST_POST_REPLIESReturn either immediate replies or the flattened full conversation for a Threads post, one cursor page at a time.

Input Parameters

string ("immediate" | "conversation")
Use immediate for top-level replies only, or conversation for a flattened list including nested replies.
string
Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue.
array
Reply fields to return. Defaults to id, text, timestamp, username, and replied-to metadata.
string
required
Root Threads post ID whose replies to list.
boolean
Whether to request reverse chronological/order behavior from Threads.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_LIST_PUBLIC_PROFILE_POSTSList one cursor page of posts from a qualifying public Threads profile by exact username. Standard or unreviewed app access is restricted to selected official Meta accounts, and returned post IDs may not support direct retrieval until the app has advanced access.

Input Parameters

integer
Maximum posts to return in this page.
string
Earliest post time as a Unix timestamp or provider-supported date string.
string
Latest post time as a Unix timestamp or provider-supported date string.
string
Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue.
array
Post fields to return. Defaults to id, text, timestamp, username, and permalink. The owner field is unavailable for public-profile posts.
string
required
Exact public Threads username without @. The profile generally needs at least 100 followers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_LOOKUP_PUBLIC_PROFILELook up a qualifying public Threads profile by exact username. Profiles generally need at least 100 followers, and standard or unreviewed app access is restricted to selected official Meta accounts.

Input Parameters

string
required
Exact public Threads username without @. The profile generally needs at least 100 followers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_REPOST_POSTRepost an existing Threads post to the connected profile; this creates a visible post.

Input Parameters

string
required
Threads post ID to repost.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_REVIEW_PENDING_REPLYApprove or ignore one pending reply; an ignored reply can later be approved.

Input Parameters

string ("approve" | "ignore")
required
Moderation decision. Approve makes the reply visible; ignore keeps it hidden.
string
required
Pending or ignored Threads reply ID to review.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_SEARCH_LOCATIONSSearch Threads locations by text, coordinates, or both. Returns the provider-ranked unpaginated result set.

Input Parameters

string
Location name, address, or other text to search for.
array
Location fields to return from id, name, address, city, country, latitude, longitude, and postal code.
number
Latitude for coordinate search; requires longitude.
number
Longitude for coordinate search; requires latitude.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_SEARCH_POSTSSearch one page of Threads posts by keyword or topic tag. Broader public results require Meta advanced access, so an empty page may reflect app-review limits rather than no public matches.

Input Parameters

integer
Maximum posts to return in this page.
string
required
Keyword or topic-tag text to search for.
string
Earliest result time as a Unix timestamp or provider-supported date string.
string
Latest result time as a Unix timestamp or provider-supported date string.
array
Post fields to return. Defaults to id, text, timestamp, username, permalink, and media_type.
string ("TEXT" | "IMAGE" | "VIDEO")
Restrict results to one media type.
string ("KEYWORD" | "TAG")
Interpret query as ordinary keywords or as a topic tag.
string ("TOP" | "RECENT")
Rank results by top relevance or recency.
string
Restrict results to this exact Threads username, without @.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: THREADS_SET_REPLY_VISIBILITYHide or unhide a top-level reply and its nested replies on a post managed by the connected profile.

Input Parameters

string
required
Top-level Threads reply ID to update.
string ("hidden" | "visible")
required
Desired reply visibility. Threads also applies the change to nested replies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not